بازگشت به بالا بستن همه

فهرست

وردپرس نسخه 3,0+مرجع توابع مورد استفاده در کد نویسی پوسته

توابع نویسنده ها

The Authorthe_author();

با استفاده از این تابع می توانید نویسنده نوشته را نمایش دهید. این تابع باید در حلقه وردپرس استفاده شود.

<?php the_author(); ?>

این تابع پارامتری ندارد.

Get The Authorget_the_author();

با استفاده از این تابع می توانید نویسنده نوشته را به صورت رشته برای استفاده در زبان PHP فراخوانی کنید. این تابع باید در حلقه وردپرس استفاده شود.

<?php $author = get_the_author(); ?>

این تابع پارامتری ندارد.

The Author Linkthe_author_link();

خروجی این تابع یک پیوند به وب سایت نویسنده نوشته است. هر کاربر می تواند آدرس وب سایت یا وبلاگش را در شناسنامه اش (کاربران > شناسه شما) وارد کند. متن پیوند گزینه ای است که کاربر برای نمایش عمومی نام انتخاب کرده. این تابع باید در حلقه وردپرس استفاده شود.

<?php the_author_link(); ?>

این تابع پارامتری ندارد.

The Author Metathe_author_meta();

تابع the_author_meta مشخصات کاربر مورد نظر شما را نمایش می دهد. اگر از این تابع در حلقه استفاده کنید، نیازی به وارد کردن آیدی نخواهد بود و اطلاعاتی که نمایش داده می شود، اطلاعات نویسنده ی نوشته فعلی خواهد بود. اگر بیرون از حلقه از این تابع استفاده کنید، آیدی کاربر می تواند وارد شود. برای برگرداندن (و نه نمایش) اطلاعات مورد نظرتان، از تابع get_the_author_meta استفاده کنید.

<?php the_author_meta( $field, $userID); ?>

$field

نوع: رشته

نام مشخصه ی مورد نظر جهت نمایش. مقادیر معتبر:

  • user_login
  • user_pass
  • user_nicename
  • user_email
  • user_url
  • user_registered
  • user_activation_key
  • user_status
  • display_name
  • nickname
  • first_name
  • last_name
  • description
  • jabber
  • aim
  • yim
  • user_level
  • user_lastname
  • user_description
  • rich_editing
  • comment_shortcuts
  • admin_color
  • plugins_per_page
  • plugins_last_view
  • ID

$userID

نوع: عدد صحیح

اگر آیدی کاربر را وارد نمایید، این تابع مشخصات کاربر مد نظر شما را نمایش خواهد داد.

The Author Poststhe_author_posts();

تعداد تمامی نوشته ی منتشر شده ی نویسنده را نمایش خواهد داد. تعداد پیش نویس ها و نوشته های خصوصی در این شمارش منظور نمی شوند. این تابع باید درون حلقه استفاده شود.

<?php the_author_posts(); ?>

این تابع پارامتری ندارد.

The Author Posts Linkthe_author_posts_link();

پیوندی به صفحه ی نمایش نوشته های های نویسنده نمایش می دهد. متن پیوند گزینه ای است که کاربر برای نمایش عمومی نام انتخاب کرده. محتوای موجود در صفحه ی نویسنده می تواند با ویرایش فایل های پوسته می تواند تغییر داده شود. این تابع باید درون حلقه استفاده شود.

<?php the_author_posts_link(); ?>

این تابع پارامتری ندارد.

WP Dropdown Userswp_dropdown_users();

یک لیست افتادنی (DropDown) شامل نویسنده های وب سایت.

<?php wp_dropdown_users($args); ?>

show_option_all

نوع: رشته

متن گزینه اتنخاب همه کاربران.

show_option_none

نوع: رشته

متن گزینه اتنخاب هیچ یک از کاربران.

orderby

نوع: رشته

معیار مرتب سازی گزینه های لیست. مقادیر معتبر:

  • 'ID'
  • 'user_nicename'
  • 'display_name' - پیش فرض

order

نوع: رشته

ترتیب مرتب سازی گزینه های لیست. مقادیر معتبر:

  • 'ASC' (سعودی - پیش فرض)
  • 'DESC' (نزولی)

include

نوع: رشته

آیدی کاربران جهت قرارگرفتن در لیست که باید با کاما (,) از یکدیگر جدا شوند. مثلا 'include=4,12' به این معناست که لیستی شامل کاربرانی با آیدی های 4 و 12 نمایش داده شود. به صورت پیش فرض تمامی کاربران در لیست قرار خواهند گرفت.

exclude

نوع: رشته

آیدی کاربران جهت چشم پوشی از قرار دادن در لیست که باید با کاما (,) از یکدیگر جدا شوند. مثلا 'exclude=4,12' به معنای عدم قرار دادن کاربرانی با آیدی های 4 و 12 در لیست می باشد. به صورت پیش فرض از هیچ کاربری چشم پوشی نخواهد شد و تمامی کاربران در لیست قرار می گیرند.

multi

نوع: بولی

تعیین نادیده گرفتن خصوصه ی ID در عنصر select. مقدار پیش فرض، False می باشد.

show

نوع: رشته

عنوان ستون کاربر در پایگاه داده جهت نمایش (تعیین نمایش کاربران بر اساس مشخصه مورد نظر). اگر عنوان انخاب شده برای یک کاربر خالی باشد، user_login نمایش داده خواهد شد.

  • 'ID'
  • 'user_login'
  • 'display_name' - پیش فرض

selected

نوع: عدد صحیح

آیدی کاربری که به صورت پیش فرض انتخاب شده است. در حالت پیش فرض کاربری انتخاب نمی شود.

name

نوع: رشته

نام اختصاص یافته به لیست. مقدار پیش فرض 'user' می باشد.

class

نوع: رشته

اگر مایلید می توانید با مقداردهی این پارامتر یک کلاس به لیست اختصاص دهید.

WP List Authorswp_list_authors();

نمایش لیستی از کاربران وب سایت.

<?php wp_list_authors($args); ?>

optioncount

نوع: بولی

نمایش تعداد نوشته های هر کاربر. مقدار پیش فرض: False.

exclude_admin

نوع: بولی

مستثنا کردن حساب کاربری مدیر (admin وارد شده است) از لیست کاربران نمایش داده شده. مقدار پیش فرض: True.

show_fullname

نوع: بولی

نمایش کامل نام (نام و نام خانوادگی) نویسندگان. اگر False باشد، گزینه ای است که کاربر برای نمایش عمومی نام انتخاب کرده. مقدار پیش فرض: False.

hide_empty

نوع: بولی

عدم نمایش کاربرانی که نوشته ای ندارند. مقدار پیش فرض: True.

echo

نوع: بولی

نمایش نتایج. مقدار پیش فرض: True.

feed

نوع: رشته

متن پیوند به فید آر اس اس هر نویسنده. این مقدار به صورت پیش فرض خالی است و فیدی نمایش داده نخواهد شد.

feed_image

نوع: رشته

مسیر/نام فایل تصویر. در صورت استفاده، عکس به فید آر اس اس هر کاربر پیوند خواهد خورد و پارامتر feed نادیده گرفته خواهد شد.

style

نوع: رشته

قالب بندی لیست نویسنده ها. گزینه list, که گزینه پیش فرض نیز می باشد، نویسنده ها را در یک لیست بدون ترتیب(unordered list) نمایش می دهد. در حالی که استفاده از گزینه none محتوا (لیست نویسندگان) را قالب بندی نمی کند و نام هر نویسنده با کاما (,) جدا می شوند. اگر مقدار گزینه html برابر false باشد این تنظیم نادیده گرفته خواهد شد. این گزینه در نسخه 2,8 افزوده شد. مقادیر معتبر:

  • list - پیش فرض
  • none

html

نوع: بولی

تنظیم قالب بندی یا عدم قالب بندی (متن ساده) خروجی تابع. اگر مقدار پارامتر html برابر false باشد، پارامتر style نادیده خواهد شد و نتایج خروجی با کاما (,) از یکدیگر جدا می گردند. این گزینه در وردپرس 2,8 افزوده شد. مفدار پیش فرض: true

کلیه حقوق متلعق به سازنده و توسعه دهنده می باشد. بازسازی و توسعه : ایران اسکریپت