وردپرس نسخه 3,0+مرجع توابع مورد استفاده در کد نویسی پوسته
توابع دسته ها
Category Descriptioncategory_description();
توضیحات دسته ی فعلی را که در بخش تنظیمات هر دسته تعیین می شود را بر می گرداند.
<?php echo category_description($category); ?>
$category
نوع: عدد صحیح
آیدی دسته ای که مایل به فراخوانی توضیحاتش هستید. اگر مقداری وارد نکنید، به طور پیش فرض توضیحات دسته فعلی فراخوانی می شود.
Single Cat Titlesingle_cat_title();
نام دسته ی صفحه فعلی را نمایش می دهد یا فراخوانی می کند. در صفحات برچسب، نام برچسب نمایش داده خواهد شد. این تابع فقط می تواند خارج از حلقه استفاده شود.
<?php single_cat_title($prefix, $display); ?>
$prefix
نوع: رشته
(اختیاری) نمایش متن قبل از عنوان.
$display
نوع: بولی
(اختیاری) آیا نام دسته باید نمایش داده شود (True) یا برای استفاده در کدهای PHP برگردانده شود (False). پیش فرض: True.
The Categorythe_category();
دسته های نوشته را با لینک به هر دسته نمایش می دهد. این تابع باید درون حلقه استفاده شود.
<?php the_category($separator, $parents, $post_id); ?>
$separator
نوع: رشته
متن یا نویسه ای که میان دسته ها قرار خواهد گرفت. به صورت پیش فرض دسته های مختلف را در یک لیست مرتب نشده (Unordered list) قرار می دهد.
$parents
نوع: رشته
چگونگی نمایش دسته های زیرمجموعه. گزینه ها:
- 'multiple' - پیوندهای جداگانه برای دسته ی مادر و دسته ی فرزند به صورت "مادر/فرزند" نمایش داده می شود.
- 'single' - تنها به دسته ی فرزند پیوند داده می شود و متن پیوند به صورت "مادر/فرزند" خواهد بود.
نکته: به صورت پیش فرض به دسته فرزند پیوند داده می شود و در متن پیوند هم فقط نام دسته فرزند درج می شود.
$post_id
نوع: عدد صحیح
آیدی نوشته مورد نظر جهت نمایش دسته ها. مقدار پیش فرض false می باشد (نوشته فعلی).
The Category RSSthe_category_rss();
نمایش دسته های نوشته در فید.
<?php the_category_rss($type); ?>
$type
نوع: رشته
(اختیاری) مقادیر قابل قبول 'rss'، 'atom' و 'rdf' می باشد. مقدار پیش فرض 'rss' است.
Dropdown Categorieswp_dropdown_categories();
نمایش یا فراخوانی یک لیست افتادنی از دسته ها.
<?php wp_dropdown_categories($args); ?>
$args
نوع: رشته
(اختیاری) با استفاده از آرگومان های دلخواه، آرگومان های پیش فرض نادیده گرفته خواهند شد. اگر این تابع بدون پارامتر استفاده شود، نتایج زیر حاصل می شود:
| <?php $args = array( | ||
| 'show_option_all' | => | , |
| 'show_option_none' | => | , |
| 'orderby' | => | 'ID', |
| 'order' | => | 'ASC', |
| 'show_last_update' | => | 0, |
| 'show_count' | => | 0, |
| 'hide_empty' | => | 1, |
| 'child_of' | => | 0, |
| 'exclude' | => | , |
| 'echo' | => | 1, |
| 'selected' | => | 0, |
| 'hierarchical' | => | 0, |
| 'name' | => | 'cat', |
| 'id' | => | , |
| 'class' | => | 'postform', |
| 'depth' | => | 0, |
| 'tab_index' | => | 0, |
| 'taxonomy' | => | 'category', |
| 'hide_if_empty' | => | false |
| ); | ||
| ?> |
- دسته ها بر اساس آیدیشان به صورت سعودی مرتب می شوند
- آخرین تاریخ به روزرسانی نمایش داده نمی شود
- تعداد نوشته های هر دسته نمایش داده نمی شود
- دسته های خالی (بدون نوشته) نمایش داده نمی شوند
- هیچ موردی چشم پوشی نمی گردد
- دسته ها را نمایش می دهد(echo)
- هیچ دسته ای به صورت پیش فرض انتخاب شده نیست
- دسته ها را به صورت درختی نمایش نمی دهد
- نام فرم 'cat' می باشد
- به فرم کلاس 'postform' نسبت داده می شود
- آیدی ای برای لیست تعیین نمی شود پس نام لیست به عنوان آیدی نسبت داده می شود
- محدودیتی در عمق دسته ها وجود ندارد
- Tab index لیست برابر 0 می باشد
- انتخاب دسته (category) ها به عنوان رده بندی (taxonomy)
- لیست افتادنی در صورت خالی بودن مخفی می شود
List Categorieswp_list_categories();
لیستی از دسته ها را به صورت پیوند نمایش می دهد. وقتی روی پیوند یک دسته کلیک شود، تمامی پست های آن دسته در صفحه نمایش دسته ها به نمایش در می آیند که می توان آن صفحه را از لحاظ ظاهری و ساختاری ویرایش نمود. توصیه می شود برای اطلاعات بیشتر، قوانین پردازش فایل های پوسته توسط وردپرس (Template Hierarchy) را ببینید.
<?php wp_list_categories($args); ?>
$args
نوع: رشته
(اختیاری) با استفاده از آرگومان های دلخواه، آرگومان های پیش فرض نادیده گرفته خواهند شد. اگر این تابع بدون پارامتر استفاده شود، نتایج زیر حاصل می شود:
| <?php $args = array( | ||
| 'show_option_all' | => | , |
| 'orderby' | => | 'name', |
| 'order' | => | 'ASC', |
| 'show_last_update' | => | 0, |
| 'style' | => | 'list', |
| 'show_count' | => | 0, |
| 'hide_empty' | => | 1, |
| 'use_desc_for_title' | => | 1, |
| 'child_of' | => | 0, |
| 'feed' | => | , |
| 'feed_type' | => | , |
| 'feed_image' | => | , |
| 'exclude' | => | , |
| 'exclude_tree' | => | , |
| 'include' | => | , |
| 'hierarchical' | => | true, |
| 'title_li' | => | __( 'Categories' ), |
| 'number' | => | NULL, |
| 'echo' | => | 1, |
| 'depth' | => | 0, |
| 'current_category' | => | 0, |
| 'pad_counts' | => | 0, |
| 'taxonomy' | => | 'category', |
| 'walker' | => | 'Walker_Category' |
| ); | ||
| ?> |
- پیوندی به "همه دسته ها" وجود ندارد
- دسته ها بر اساس نامشان به صورت سعودی مرتب می شوند
- آخرین نوشته به روز شده را نمایش نمی دهد (آخرین نوشته به روزرسانی شده در هر دسته)
- دسته ها در یک لیست بدون ترتیب (Unordered list) نمایش داده می شوند
- تعداد نوشته های هر دسته نمایش نمی یابد
- تنها دسته های دارای نوشته نمایش داده می شوند
- خاصیت عنوان (title) هر پیوند، توضیح آن دسته است
- لیست با دستور child_of محدود نشده است. اگر از این دستور استفاده شود تنها دسته های فرزند دسته ی مادر مورد نظر به نمایش در می آیند
- از فید یا عکس فید استفاده نمی شود
- هیچ دسته ای چشم پوشی نمی شود و تمامی دسته ها در لیست قرار می گیرند
- به دسته فعال (اگر کاربر در حال دیدن یک دسته باشد) کلاس 'current-cat' افزوده می شود
- دسته ها به صورت درختی نمایش می دهد
- دسته به عنوان تیتر بالای لیست نمایش داده می شود
- محدودیتی توسط دستورات SQL اعمال نمی شود ('number' => 0 در بالا نوشته نشده است)
- دسته ها را نمایش می دهد (echo)
- محدودیتی در عمق دسته ها وجود ندارد
- تمامی دسته ها نمایش داده می شوند
- لیست توسط کلاس Walker_Category ارائه می شود