توابع وردپرس – توابع نویسنده ها
سلام
با دومین قسمت از معرفی توابع وردپرس در خدمتتون هستیم، در این مطلب می پردازیم به معرفی توابع نویسنده ها در وردپرس.
- تابع the_author
با استفاده از این تابع می توانید نویسنده نوشته را نمایش دهید. این تابع باید در حلقه وردپرس استفاده شود.
۱ |
<?php the_author(); ?> |
این تابع پارامتری ندارد.
- تابع get_the_author
با استفاده از این تابع می توانید نویسنده نوشته را به صورت رشته برای استفاده در زبان PHP فراخوانی کنید. این تابع باید در حلقه وردپرس استفاده شود.
۱ |
<?php $author = get_the_author(); ?> |
این تابع پارامتری ندارد.
- تابع the_author_link
خروجی این تابع یک پیوند به وب سایت نویسنده نوشته است. هر کاربر می تواند آدرس وب سایت یا وبلاگش را در شناسنامه اش (کاربران > شناسه شما) وارد کند. متن پیوند گزینه ای است که کاربر برای نمایش عمومی نام انتخاب کرده. این تابع باید در حلقه وردپرس استفاده شود.
۱ |
<?php the_author_link(); ?> |
این تابع پارامتری ندارد.
- تابع the_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_posts
تعداد تمامی نوشته ی منتشر شده ی نویسنده را نمایش خواهد داد. تعداد پیش نویس ها و نوشته های خصوصی در این شمارش منظور نمی شوند. این تابع باید درون حلقه استفاده شود.
۱ |
<?php the_author_posts(); ?> |
این تابع پارامتری ندارد.
- تابع the_author_posts_link
پیوندی به صفحه ی نمایش نوشته های های نویسنده نمایش می دهد. متن پیوند گزینه ای است که کاربر برای نمایش عمومی نام انتخاب کرده. محتوای موجود در صفحه ی نویسنده می تواند با ویرایش فایل های پوسته می تواند تغییر داده شود. این تابع باید درون حلقه استفاده شود.
۱ |
<?php the_author_posts_link(); ?> |
این تابع پارامتری ندارد.
- تابع wp_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’ به این معناست که لیستی شامل کاربرانی با آیدی های ۴ و ۱۲ نمایش داده شود. به صورت پیش فرض تمامی کاربران در لیست قرار خواهند گرفت.
exclude
نوع: رشته
کار: آیدی کاربران جهت چشم پوشی از قرار دادن در لیست که باید با کاما (,) از یکدیگر جدا شوند. مثلا ‘exclude=4,12’ به معنای عدم قرار دادن کاربرانی با آیدی های ۴ و ۱۲ در لیست می باشد. به صورت پیش فرض از هیچ کاربری چشم پوشی نخواهد شد و تمامی کاربران در لیست قرار می گیرند.
multi
نوع: بولین
کار: تعیین نادیده گرفتن خصوصه ی ID در عنصر select. مقدار پیش فرض، False می باشد.
show
نوع: رشته
کار: عنوان ستون کاربر در پایگاه داده جهت نمایش (تعیین نمایش کاربران بر اساس مشخصه مورد نظر). اگر عنوان انخاب شده برای یک کاربر خالی باشد، user_login نمایش داده خواهد شد.
- ‘ID’
- ‘user_login’
- ‘display_name’ – پیش فرض
selected
نوع: عدد صحیح
کار: آیدی کاربری که به صورت پیش فرض انتخاب شده است. در حالت پیش فرض کاربری انتخاب نمی شود.
name
نوع: رشته
کار: نام اختصاص یافته به لیست. مقدار پیش فرض ‘user’ می باشد.
class
نوع: رشته
کار: اگر مایلید می توانید با مقداردهی این پارامتر یک کلاس به لیست اختصاص دهید.
- تابع wp_list_auhtors
نمایش لیستی از کاربران وب سایت.
۱ |
<?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 باشد این تنظیم نادیده گرفته خواهد شد. این گزینه در نسخه ۲,۸ افزوده شد. مقادیر معتبر:
- list – پیش فرض
- none
html
نوع: بولین
کار: تنظیم قالب بندی یا عدم قالب بندی (متن ساده) خروجی تابع. اگر مقدار پارامتر html برابر false باشد، پارامتر style نادیده خواهد شد و نتایج خروجی با کاما (,) از یکدیگر جدا می گردند. این گزینه در وردپرس ۲,۸ افزوده شد. مفدار پیش فرض: true
معرفی توابع بخش نویسنده ها در وردپرس به پایان رسید.
مشکلی یا سوالی در رابطه با این مطلب داشتید، در سایت بپرسید ، پاسخگوی سوالات شما هستیم.
موفق باشید.
ارسال نظر
شما باید وارد شوید یا عضو شوید تا بتوانید نظر ارسال کنید