سلام ، یه چند روزی نبودم داشتم یه مقاله همچین طویل مینوشتم در مورد وردپرس تا بروبچ بتونن راحت تر با این سیستم مشتی کار کنن و همچنین قالبهای فارسی بیشتری براش ساخته بشه ! روی این مقاله حدود ۴ روز وقت گذاشتم.

در این مقاله ما فرض رو بر این میگیریم که شما میدونید وردپرس چیه و با اصلاحات عادی طراحی وب آشنایی دارید ( اگه هم آشنایی ندارید با هم آشناتون میکنم ! ) ، هدف اصلی این مقاله ساده تر کردن کار طراحان برای ساختن قالب برای وردپرسه ، من تقریبا تمامی توابع مورد نیاز برای طراحی رو در اینجا توضیح دادم…

پی‌نوشت : مقاله رو با اضافه کردن چند مثال برای توابعی که احتیاج به مثال داشتن ، کامل‌تر کردم ;)

خب بریم سر اصل مطلب :

یه اصطلاحی که ممکنه براتون ناآشنا باشه حلقه‌ی وردپرس هست ، منظور از حلقه‌ی وردپرس اون حلقه‌ای هست که هی تکرار میشه و پستها رو از دیتابیس میخونه و نشون میده و چیزایی که شامل این حلقه میشن عناصری هستن که شما بصورت ثابت توی همه‌ی پستهاتون تکرار میکنین ! پس هرجا گفتیم خارج از حلقه‌ی وردپرس یعنی نباید توی همه‌ی پستها تکرار بشه !

یه توضیح دیگه در مورد پارامترها باید بدم ، منظور من از پارامتر عبارتهایی هست که بین دو تا پرانتز توابع نوشته میشه ( بین دو تا علامت ” باید نوشته بشن پارامترها ) و با یک علامت کاما از هم جدا میشن ، وقتی مثلا ۵ تا پارامتر رو پشت سر هم معرفی میکنم بدونین ترتیب اونا توی نوشتنشون بین پرانتزها مهمّه ، اگه ترتیب پارامترها رو رعایت نکنین تابع اجرا نمیشه ( یا ارور میده )
خب اگه ما بین ۵ تا پارامتر فقط بخوایم ۳ تا رو تغییر بدیم چیکار بکنیم ؟؟
اونایی که لازمه تغییر بدین رو بصورت دلخواه تغییر میدین و اونایی که نیازی به تغییر ندارن رو همون مقدار پیش فرضشون قرار میدین تا خیالتون راحت باشه برنامه حتما اجرا میشه !
مثال :

Function(”1st-parameter”,”2nd-parameter”,”3rd parameter”,”4th-parameter”,”5th-parameter”)

حالا ما میخوایم پارامتر دوم و چهارم رو تغییر بدیم ( مقادیر پیش‌فرض همونایی هستن که توی تابع بالا اومدن )

Function(”1st-parameter”,”parametere-delkhahe-ma”,”3rd parameter”,”parametere-delkhahe-ma”,”5th-parameter”)

دیگه بریم سربخت توایع خود خود وردپرس عزیز :

تابع اطلاعات بلاگ Blog info tag :

< ?php bloginfo() ?>

خروجی این تابع اطلاعاتی در مورد وبلاگ شما است ، به بررسی پارامترهای این تابع
میپردازیم :

• name : این پارامتر نام وبلاگ شما را به نمایش در میآورد (نامی که در
  قسمت Options وارد کرده‌اید) ، پارامتر name ، پارامتر پیش‌فرض این تابع نیز هست
  یعنی اگه شما بدون هیچ پارامتری این تابع رو بکار ببرین ، خروجی مشابهی خواهید داشت
  ، مثال :

  < ?php bloginfo(”name”) ?>

  در خروجی خواهیم داشت (برای این بلاگ !‌) :

  Gonahkar گناهکار

• url : لینک بلاگ شما را به نمایش در می‌آورد
• description : توضیحات بلاگ شما را به نمایش در می‌آورد (توضیحاتی که در قسمت Tagline در قسمت Options وارد کرده‌اید)
• admin_email : آدرس ایمیل مدیر سایت را به نمایش در می‌آورد ؛ ایمیلی که در قسمت Profile وارد کرده‌اید
• rss_url : آدرس فایل wp-rss2.php را نشان خواهد داد.
• pingback_url : آدرس فایل xmlrpx.php را نمایش میدهد. برای استفاده از این پارامترها مثل اون مثال
  بالایی باید اونا رو بین دو تا پرانتز تایع بنویسین ! ( خودت فهمیدی یا کسی کمکت کرد IQ ! )

توابع تاریخ و زمان Date and Time tag :

< ?php the_date() ?>

این تابع همونطور که از اسمش تابلوه در مورد تاریخ و زمان و این جورچیزاست. این
تابع زمان انتشار مطالب شما را نشون میده و بصورت پیش‌فرض دارای فرم dd.mm.yy است (اگر
در قسمت Options فرمت آن را تغییر نداده باشید !) ، شما میتونین در قسمت Options
فرمت این تابع رو بر اساس تابع Date خود PHP عوض کنین ! این تابع در هر روز فقط یک
بار نشون داده میشه ، یعنی اگه شما توی یه روز ۴ تا پست بنویسین این تابع فقط
بالای این ۴ پست نمایش داده میشه و بالای همه‌ی پست‌ها خودش رو نشون نمیده ! (افتاد
یا بیشتر توضیح بدم ؟!)
پارامترها :

• فرمت تابع (پیش فرض همون dd.mm.yy هست) اگه شما دراین پارامتر چیزی رو برای تابع تعریف کنین (مثلا dd.mm.Y ) دیگه اون چیزی که توی قسمت Options معرفی میکنین ول‌معطل میشه !
• رشته‌ای که قبل از تاریخ به نمایش در می‌اد
• رشته‌ای که بعد از تابع به نمایش در می‌اد.

مثال :

< ?php the_date("l , F j , Y","###","+++") ?>

در خروجی داریم :

### Saturday 25 December 2004 +++

اگه شما میخواین که همه‌ی پستهاتون تاریخ رو نشون بدن میتونین از تابع the_time() استفاده کنین ! به شرطی که خودتون یه رشته به فرم تاریخ براش تعریف کنین ، مثلا اگه بخواین زیر هر پستتون تاریخ و ساعت رو بصورت زیر داشته باشین :

۲۵/۱۲/۲۰۰۱ @ ۸:۰۴:۵۰ AM

باید رشته‌ی زیر رو در تابع مربوطه بنویسین ، اینطوری :

the_time("d.m.Y @ g:i:s A")

خب اگه شما بخواین مثلا فقط تاریخ رو طوی هر پست نشون بدین باید رشته‌ای بصورت زیر برای تابع تعریف کنین :

the_time("d.m.Y")

خب اگه شما بخواین زمان فرستاده شدن پستتون رو نشون بدین میتونین از تابع زیر بدون هیچ رشته‌ای استفاده کنین :

the_time()

که این باعث میشه خروجی رو بصورت زیر داشته باشیم چون رشته‌ی پیش‌فرض تابع بصورت hh:mm:ss هست یعنی خروجی مشابه زیر خواهیم داشت :

۱۸:۳۷:۰۰

البته شما میتونین بدون دستکاری تابع و از قسمت Options بلاگتون رشته‌ی مورد نظر رو بصورت دلخواه در بیارین ! فقط این نکته‌ی مهم رو یادتون باشه که اگه شما توی سورس کدتون برای این توابع رشته‌ای رو بصورت دستی تعیین کنید دیگه اون مقادیری که توی
Options تعریف میکنین هیچ کاری رو انجام نمیدن ! یادتون نره ! ( فردا هی به ما فحش میدین ، میگین یارو هیچی بارش نبود حرف مفت میزد ! ) خب در مورد تاریخ و زمان دو تا تابع دیگه داریم که بنظر من خیلی بیخودی هستن ! اما حالا که دارم همه رو میگم اینا هم روش ! اولی تابع

< ?php the_weekday() ?>

هست که اسم روز رو چاپ میکنه ، و مثل تابع the_time() میتونه توی همه‌ی مطالب تکرار بشه ! تابع دیگه‌ای هم که هست اینه :

< ?php the_weekday_date() ?>

که این هم مثل اون اولی کار میکنه با این تفاوت که این فقط یه بار در طول روز چاپ میشه ( مثل تابع the_date() ) ، البته این تابع ۲ تا پارامتر هم میگیره که اولی رشته‌ای هست که قبل از اسم روز نشون میده و دومی هم چیزیه که بعد از اسم روز نشون میده ! بصورت :

< ?php the_weekday_date("### "," +++") ?>

خروجی :

### Friday +++

توابع پست و محتوا Post/Content tags :

< ?php the_ID() ?>

این تابع ID پست رو نشون میده و هیچ پارامتری هم نداره !

تابع زیر برای نشون دادن عنوان پست استفاده میشه :

<?php the_title() ?>

این تابع ۲ تا پارامتر داره که اولی برای چیزیه که میخواین قبل از عنوان پست نشون داده بشه و دومی هم برای چیزیه که بعد از عنوان نشون داده میشه ، برای مثال :

the_title("« "," »")

خروجی :

« عنوان پست »

تابع بعدی که معرفی میکنم ، تابع the_content() هست که ۳ پارامتر داره و کار اطلیش هم نشون دادنه متن پست‌هایی هست که منتشر میشن !

<?php the_content() ?>

اولین پارامتری که میتونین واسه این تابع تعریف کنین جای عبارت more… * رو میگیره ، یعنی وقتی شما از این امکان وردپرس استفاده کنین عبارت دلخواه شما بجای عبارت more… میشینه، مثلا برای وبلاگهای فارسی بهتره از عبارت ادامه‌ی مطلب استفاده کنین !
* برای اون دسته از دوستانی که هنوز نمیدونن more… چیه و کجا استفاده میشه باید عرض کنم که بعضی وقتا شما پستی دارین که خیلی زیاده (مثل همین پست) و نمیخواین که همه‌ی اون پست رو توی صفحه‌ی اول بلاگتون نمایش بدین به همین خاطر با استفاده از کد

<!–more–>

قسمتی از پستتون رو که بعد از این عبارت قرار میگیره توی صفحه‌ی کامل مطلب قرار میدین ! (افتاد ؟!)
دومین پارامتر تابع the_content() فقط عدد ۱ یا ۰ رو میتونه بگیره ، والا نفهمیدم واسه چیه ! چرا دروغ بگم !!! توی راهنمای انگلیسیش نوشته :

۰ or 1, indicating whether you want to show the teaser message when showing the complete text (default is 1).

دیگه تحلیل و تفسیرش با خودتون ! (اگه کسی میدونه این پارامتر کارش چیه یه ندایی هم به من بده !)
سومین پارامتری که این تابع میگیره اسم یه فایل تمپلیت هست برای اینکه وقتی شما به ادامه‌ی مطلب مراجعه کنین پست شما توی اون تمپلیت نشون داده بشه ! در واقع آدرس تمپلیتی هست بجز تمپلیت اصلی سایتتون ! (مقدار پیش فرض این پارامتر همون تمپلیت اصلی بلاگ خودتونه !)
مثال : فرض کنین میخواین بجای عبارت more… عبارت baghiye نشون داده بشه و وقتی بازدید کننده به متن کامل مراجعه کرد صفحه‌ی جدید توی تمپلیتی که توی فایل NewTemp.php درست کردین نشون داده بشه ، برای این کار تابع مذکور رو بصورت زیر ادیت میکنین :

the_content("baghiye","1","NewTemp.php")

با این کد اون چیزی رو که میخواستین براحتی ایجاد کردین ! ;)

<?php single_post_title() ?>

این تابع خارج از حلقه‌ی وردپرس استفاده میشه ، خروجی این تابع عنوان پست شماست ، البته وقتی که به لینک دائم مراجعه کنین یعنی وقتی که صفحه‌ی index.php رو با متغیر ?p= ببینیم ، این تابع اکثرا در عنوان صفحه استفاده میشه ، به این صورت :

<title><?php bloginfo(’name’) ?><?php single_post_title() ?></title>

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

<?php next_post() ?>

این تابع لینکی به پستهای بعدی شما ایجاد میکنه ( وقتی که کسی به لینک دائم پستتان مراجعه میکند ، مثل همین بلاگ ! ) برای درک این موضوع به لینک دائم یکی از پستهای گذشته‌ی من مراجعه کنین ، کنار عنوان پست یه دونه لینک به پست قبلی هست یکی هم به پست بعدی !
میرسیم به پارامترهای این تابع :

• اولین پارامتر این تابع مربوط میشه به فرمت خروجی اون ، یعنی اینکه چجوری دیده بشه لینک مورد نظر ، توی این پارامتر شما اگه جایی از ٪ استفاده کنین ، تابع خودبخود لینک رو بجای ٪ قرار میده

مثلا اگه بخواین لینکتون به صفحه‌ی بعدی اینطوری باشه :

~~ NextPostTitle **

باید تابع رو بصورت زیر ادیت کنین :

<?php next_post("~~ % **") ?>

• پارامتر بعدی عبارتی هست که قبل از لینک بنمایش در می‌آد که با توجه به پارامتر بالا چیز مزخرفی بنظر میرسه !
• پارامتر بعدی فقط مقدار yes یا no میگیره ، سوالش هم اینه : آیا میخواید عنوان پست بعدی هم نشون داده بشه توی لینک ؟ اگه دلتون بخواد ( که میخواد ) میزارین yes اگه هم دوست دارین لجبازی کنین میزنین no ( مقدار پیش‌فرض yes هست )
• پارامتر بعدی هم فقط yes یا no میگیره ، سوالی هم که میکنه اینه : آیا میخواید فقط لینکهایی که در دسته‌بندی (Category) مشابه هستن نشون داده بشن ؟ ( مقدار پیش فرض برای این پارامتر no هست )
• پارامتر بعدی هم فقط عدد دریافت میکنه ، این عدد نشون دهنده‌ی تعداد پستهای بعدی هست که میخواید لینکشون نشون داده بشه یعنی اگه این عدد رو ۲ تنظیم کنین لینک ۲ پست بعدی نشون داده میشه ( یه موقع فکر نکنین دو تا لینک نشون میده ها ! نه ! لینک پست بعدی رو نشون نمیده ، لینک پست بعدشو نشون میده ، افتاد ؟ یعنی اگه id پست جاری ۱۰ باشه با این کار شما لینک پستی با idه ۱۲ نشون داده میشه ! امیدوارم افتاده باشه ! )

مثال کلی : اگه شما بخواید لینکتون بصورت زیر باشه

~~ NextPostTitle **

و عنوان پست بعدی هم نشون داده بشه و همه‌ی پستها رو هم شامل بشه باید کدتون به اینصورت باشه :

<?php next_post("~~ % **","","yes","no",1) ?>

تابعی دیگه‌ای هم هست که دقیقا توضیحاتش مثل تابع بالاییه با این تفاوت که اونو برای پستهای قبلی استفاده میکنن :

<?php previous_post() ?>

دیگه نیازی به توضیح نداره !

<?php single_month_title() ?>

این تابع اسم ماه رو در صفحاتی که بصورت آرشیو ماهیانه نشون داده میشه بنمایش در میاد ، یعنی وقتی شما index.php رو با ?m= لود میکنین ! بهترین راه استفاده از این تابع در title صفحه هست بصورت زیر :

<title><?php bloginfo(’name’) ?><?php single_month_title() ?></title>

و یدونه پارامتر هم داره که اون عبارتی هست که قبل از اسم ماه نشون داده میشه که بصورت پیش‌فرض :: قرار داده شده !

<?php link_pages() ?>

کار این تابع نشون دادن لینک صفحات بعدی برای پستهایی هست که توی چند صفحه منتشر میشن ( با استفاده از <!– nextpage –> )
پارامترهای این تابع :

• رشته‌ای که قبل از این تگ نشون داده میشه ( پیش‌فرض <br /> هست )
• رشته‌ای که بعد از این تگ نشون داده میشه ( پیش‌فرض <br /> هست )
• این پارامتر ۲ مقدار رو قبول میکنه next یا number که اولی واسه اینه که لینکها رو بصورت next/previous page نشون بده و دومی بصورت شماره‌ی صفحات ، اینطوری ۱ ۲ ۳ ۴ ( بصورت پیش فرض روی number قرار داده شده )
• رشته‌ای که بجای عبارت next page نشون داده میشه ( در صورتی که پارامتر بالا رو روی next تنظیم کرده باشین )
• رشته‌ای که بجای عبارت previous page نشون داده میشه ( با همون شرط بالا )
• این پارامتر فرمت لینک صفحات را مشخص میکند ، یعنی هر جا ٪ بزارین بجاش عدد صفحه رو نشون میده
• اسم فایلی که میخواید صفحات توی اون لود بشن ؛ یه تمپلیت دیگه منظورمه !

مثال : فرض کنید شما میخواید قبل از تعداد صفحات عبارت before و بعد از اون عبارت after نشون داده بشه و شماره‌ی صفحات هم نشون داده بشه و فرمت لینک صفحات هم بصورت ~۱~ باشه ( مثال برای صفحه اول بود ) و صفحات بعدی توی فایلی بنام NewTemp.php لود بشن ؛ به این صورت عمل میکنیم :

<?php link_pages(’before’,'after’,'number’,”,”,’ ~%~ ‘,’newTemp.php’); ?>

خواهیم داشت :

before ~1~ ~2~ ~3~ ~4~ ~5~ after

توابعی که در مورد نویسنده هستن Author tags :
تمامی نتایج این توابع به تنظیمات قسمت Profile نویسنده بلاگ بستگی دارد

<?php the_author() ?>

اسم نویسنده ( یا لقب ) رو نشون میده !

بقیه توابع رو دیگه توضیح نمیدم چون کاملا واضح هستن و بصورت دست نخورده همینجا کپی میکنم :

<?php the_author_email() ?> - the author’s email.
<?php the_author_url() ?> - the author’s url.
<?php the_author_icq() ?> - the author’s ICQ number.
<?php the_author_aim() ?> - the author’s AIM handle.
<?php the_author_yim() ?> - the author’s Yahoo Messenger handle.
<?php the_author_msn() ?> - the author’s MSN Messenger handle.
<?php the_author_posts() ?> - the author’s post count.
<?php the_author_login() ?> - the author’s login name in WordPress.
<?php the_author_ID() ?> - the author’s ID number in WordPress.

توابع دسته‌بندی Category tags :

<?php the_category() ?>

این تابع اسم دسته‌بندی رو نشون میده که یه پارامتر هم میگیره و اون عبارتی هست که بین اسم دو تا دسته‌بندی نشون داده میشه ( وقتی شما برای یک پستتون ۲ تا دسته‌بندی تعریف میکنین ) ، پیشنهاد میکنم حتما یه چیزی براش تعریف کنین چون بصورت پیش‌فرض اسم دسته‌بندی بصورت لیست هست ولی با این کار از حالت لیست در می‌آد ! مثلا :

< ?php the_category(' * ') ?>

حالا اگه شما واسه یه پستتون ۲ تا دسته‌بندی تعریف کنین ، بصورت زیر لیست دسته‌بندی‌ها رو خواهید داشت :

DasteBandi1 * DasteBandi2

تابع بعدی

<?php the_category_ID() ?>

هست که شماره‌ی ID دسته‌بندی مربوطه رو نشون میده

<?php get_links_list() ?>

خارج از حلقه‌ی وردپرس ؛ این تابع لینکهایی رو که در قسمت Links Manager هستن رو نمایش میده.
این تابع ۱ پارامتر هم داره که میتونه مقادیر ‘name’ ، ‘updated’ ، ‘id’ رو بگیره که ‘name’ بر اساس حروف الفبا ، ‘updated’ بر اساس زمان به روز شدن و ‘id’ بر اساس اولویت اضافه شدن هست !

<?php dropdown_cats() ?>

خارج از حلقه‌ی وردپرس ؛ خروجی این تابع در لیستهای باز شونده ( Drop Down Menu ) مورد استفاده قرار میگیره ، این تابع لیستی از کدهای زیر رو ایجاد میکنه :

<option name="x">category-name</option>

که x شماره‌ی دسته‌بندی و category-name اسم دسته‌بندی هستن ، شما باید به صورت زیر از این تابع استفاده کنین :

<form action="<?php echo $PHP_SELF ?>" method="get">
<select>
<?php dropdown_cats() ?>
</select>
<input type="submit" name="submit" value="view" />
</form>

این تابع چند پارامتر هم داره که در زیر توضیح میدیم :

• پارامتر اول این تابع فقط ۱ یا ۰ رو میگیره ، اگه مقدار ۱ رو انتخاب کنین در لیستی که ایجاد میشه یک گزینه بنام All هم وجود داره که بوسیله‌ی اون میتونین پستهای موجود در همه‌ی دسته‌بندی‌ها رو مشاهده کنین و اگه ۰ قرار بدین اون گزینه‌ی All نشون داده نمیشه ! ( پیش‌فرض ۱ هست )
• عبارتی که شما دوست دارید جای کلمه‌ی All نمایش داده بشه ! ( در صورتی که پارامتر بالا رو ۱ تنظیم کرده باشین )
• این پارامتر تعیین میکنه که دسته‌بندی‌ها بر چه اساسی چیده بشن که ۲ انتخاب وجود داره اولی ‘ID’ هست که بر اساس مشخصه‌ای که از دیتابیس خونده میشه میچینه دسته‌بندی‌ها رو و دومی ‘name’ هست که بر اساس حروف الفبا این کارو انجام میده ( پیش‌فرض IDه )
• این پارامتر چگونگی مرتب شدن رو تنظیم میکنه که ۲ تا حالت داره یکی asc که بصورت صعودی مرتب میکنه و یکی هم desc که بصورت نزولی مرتب میکنه ؛ یعنی اگه شما بر اساس ID دسته‌بندیهاتونو چیده باشین و این پارامتر رو هم desc انتخاب کرده باشین ، دسته‌بندی با آی‌دیه ۵ بالای دسته‌بندی با آی‌دیه ۴ قرار میگیره توی اون لیست باز‌شونده و اگر asc رو انتخاب کرده باشین برعکس این موضوع اتفاق می‌افته ( پیش‌فرض asc هست )
• این پارامتر هم فقط ۱ یا ۰ رو قبول میکنه ، اگه ۱ رو انتخاب کنین تاریخ آخرین پستی که توی اون دسته‌بندی شده رو جلوی اسمش نشون میده ( پیش‌فرض ۰ هست )
• در این پارامتر ۱ بمعنی اینه که تعداد پستهایی که توی اون دسته‌بندی داده شده رو نمایش بده جلوی اسمش ( پیش‌فرض ۰ هست )
• این پارامتر هم فقط ۰ و ۱ رو قبول میکنه ؛ در این پارامتر ۱ بمعنی این هست که دسته‌بندی هایی که هیچ پستی توی اونا داده نشده رو نمایش نده ! ( پیش‌فرض ۱ هست )

مثال : فرض کنید شما میخواید توی لیستتون یه گزینه باشه که با انتخاب اون پستهای توی همه‌ی دسته‌بندی‌ها نشون داده بشه و عبارتی که این کار رو بکنه hameh باشه و دسته‌بندی‌ها هم بر اساس اولویت حروف الفبا چیده بشن و چیده شدن هم طوری باشه که حرف اول الفبا در بالا قرار بگیره و حرفهای بعدی در پایین‌تر و دوست ندارین تاریخ آخرین پست نشون داده بشه ولی تعداد پستها رو میخواین که نشون بده و دسته بندی‌های خالی هم نشون داده بشن.
باز هم فرض رو بر این میگیریم که شما ۳ تا دسته‌بندی با نامهای Computer ، PHP و Webdesign دارید و توی هر کردوم بترتیب ۰ ، ۳ و ۷ تا پست دادین ؛ به این صورت عمل میکنیم :

<form action="<?php echo $PHP_SELF ?>" method="get">
<select>
<?php dropdown_cats(’1′,’hameh’,'name’,'asc’,'0′,’1′,’1′) ?>
</select>
<input type="submit" name="submit" value="view" />
</form>

که خروجی هم بصورت زیر هست :

تابع بعدی :

<?php list_cats() ?>

این تابع هم لیستی از دسته‌بندی‌ها رو ایجاد میکنه ( لیست معمولیه ؛ باز شونده و بسته شونده و این چیزا نیست ! ) ، ۴ پارامتر اول این تابع مثل تابع بالایی هستن و هیچ فرقی با هم ندارن اما پارامترهای دیگه‌ای داره که احتیاج به توضیح دارن ! ( پارامترهای ۵ و ۶ ) :

• نام فایل تمپلیتی که شما میخواین دسته‌بندی‌هاتون توی اون نشون داده بشن ! ( مثل این پارامتر رو قبلا چند بار داشتیم پس نیاز به توضیح واضحات نیست ! )
• این پارامتر فقط ۰ و ۱ قبول میکنه ، اگه ۱ بزارین دسته‌بندی‌ها رو بوسیله‌ی عنصر <li> درست میکنه و اگه ۰ بزارین معمولی میچینه دسته‌بندی‌ها رو ( پیش فرض ۱ هست )*

سه پارامتر آخر این تابع هم مثل ۳ پارامتر آخر تابع بالایی هستن !
* واسه اون دسته از دوستانی که با تگ <li> آشنایی ندارم باید عرض کنم که این تگ یه مدل لیست رو ایجاد میکنه ، درست مثل همین پارامترهایی که این بالا میبینین ( که یدونه دایره‌ی مشکی بغلشون هست ).

مثال : فرض کنید شما میخواید توی لیستتون یه گزینه باشه که با انتخاب اون پستهای توی همه‌ی دسته‌بندی‌ها نشون داده بشه و عبارتی که این کار رو بکنه hameh باشه و دسته‌بندی‌ها هم بر اساس اولویت حروف الفبا چیده بشن و چیده شدن هم طوری باشه که حرف اول الفبا در بالا قرار بگیره و حرفهای بعدی در پایین‌تر و دسته‌بندی‌ها توی فایلی به اسم NewTemp.php نشون داده بشن و لیستی با عنصر <li> داشته باشین ، میخواین تاریخ آخرین پست و تعداد پستها رو نشون بده و دسته بندی‌های خالی هم نشون داده بشن.
باز هم فرض رو بر این میگیریم که شما ۳ تا دسته‌بندی با نامهای Computer ، PHP و Webdesign دارید و توی هر کردوم بترتیب ۰ ، ۳ و ۷ تا پست دادین و تاریخ آخرین پستتون توی دسته‌بندی‌ها بترتیب ۲۶/۱۰ ، ۲۷/۱۰ ، ۲۹/۱۰ باشه ؛ به این صورت عمل میکنیم :

<?php list_cats(’1′,’hameh’,'name’,'asc’,'NewTemp.php’,'1′,’0′,’1′,’1′) ?>

و در خروجی داریم :

تابع بعدی :

<?php single_cat_title() ?>

خارج از حلقه‌ی وردپرس ؛ مشابه این تابع رو هم چندجای دیگه داشتیم ، از همون توابعی که اسم عنصر رو نشون میدن توی صفحه‌ی اختصاصیش و بهترین جا برای استفاده ازشون توی title صفحه هست !

توابع لینک دائم Permalink tags :

<?php permalink_anchor() ?>

این تابع یک

<a name="…"></a>

را بوجود میآورد که بجای … ، ID یا Name پست را قرار دهد ؛ این تابع فقط یدونه پارامتر داره که مشخص میکنه توی اون لینک id قرار بگیره یا name ؛ همین !

<?php permalink_link() ?>

این تابع فقط هنگامی که شما آرشیو را بصورت ماهیانه انتخاب کرده باشید عمل خواهد کرد ، این تابع لینک را بنمایش در نمی‌آورد بلکه شما باید بصورت دستی لینک آنرا بصورت زیر درست کنید :

<a href="<?php permalink_link() ?>">text of the link</a>

پارامترها :

• نام فایلی که میخواهید پست در آن بنمایش در بیاید ( پیش‌فرض تمپلیت جاری بلاگ میباشد ! )
• این پارامتر دو متغیر را قبول میکند اولی ‘id’ است که لینک را با پسوند #۵۰ بنمایش در میآورد و دومین متغیر هم ‘title’ است که لینک را با پسوند #title_of_post_50 بنمایش درمی‌آورد !

( البته در توضیحی که باید بدم برای پارامتر دوم ما برای مثال پستی رو انتخاب کردیم که آیدیش توی دیتابیس ۵۰ باشه و عنوانش هم title_of_post_50 که با توجه به اینکه هر پست آیدیه منحصربفرد داره در نتیجه انتهای همه‌ی لینکهایی که این تابع میسازه با هم فرق دارن ، فردا نیاین یقه‌ی ما رو بگیرین ! )

<?php permalink_single() ?>

این تابع هم از همون روش تابع بالایی استفاده میکنه با این تفاوت که این تابع متن کامل پست رو نشون میده ( به همراه نظرات ! ) ؛ برای این تابع هم باید خودتون بصورت دستی لینک رو بسازید :

<a href="<?php permalink_single() ?>">text of the link</a>

این تابع یک پارامتر هم میگیره که اسم فایل تمپلیت هست ( دیگه زبونم مو در اورد از بس گفتم اسم فایل تمپلیت ! )

توابع نظرات ، دنبالک و پینگ‌بک Comments, Trackback, and Pingback tags :

<?php comments_popup_script() ?>

این تابع کدهای جاوا اسکریپت مورد نیاز برای باز شدن پنجره‌ی نظرات بصورت پاپ‌آپ ( PopUp ) رو ایجاد میکنه ! شما این تابع را باید قبل از تگ </head> در تمپلیتتون قرار بدین !
پارامترها :

• عرض پنجره ( پیش‌فرض ۴۰۰ است )
• ارتفاع پنجره ( پیش‌فرض ۴۰۰ است )
• آدرس فایلی که میخواید نظرات توی اون نشون داده بشن ( پیش‌فرض wp-comments-popup.php است )

مثال : اگه بخواید عرض پنجره‌ای که باز میشه ۳۵۰ باشه و ارتفاعش هم ۲۰۰ باشه و نظرات توی فایل NewTemp.php نمایش داده بشن از کد زیر استفاده میکنین :

<?php comments_popup_script(’350′,’200′,’NewTemp.php’) ?>

تابع بعدی :

<?php comments_popup_link() ?>

این تابع لینک باز شدن نظرات در پنجره‌ی جدید را ایجاد میکند همراه با تعداد نظران !
پارامترها :

• عبارتی که برای پستهای بدون نظر نمایش داده میشود ( پیش‌فرض no comment است )
• عبارتی که برای پستهایی با ۱ نظر نمایش داده میشود ( پیش‌فرض ۱ comment است )
• عبارتی که برای پستهایی با ۲ نظر یا بیشتر نمایش داده میشود ( پیش‌فرض % comments است که علامت ٪ با تعداد نظرات جایگزین میشود )
• در این قسمت شما میتوانید کلاس ( CSS Class ) خاصی برای لینک صفحه‌ی نظرات تعیین کنید ، کافیست اسم کلاس مورد نظر را در این پارامتر بنویسید

مثال : اگه بخواید برای پستهای بدون نظر عبارت Bedoone Nazar و برای پستهای با یک نظر عبارت Yedoone Nazar و برای پست مثلا با ۵ نظر عبارت ۵ ta nazar نمایش داده بشه و کلاس css ی که برای این لینکها تعریف کردین اسمش kelas باشه ؛ بصورت زیر عمل میکنیم :

<?php comments_popup_link(’Bedoone Nazar’,'Yedoone Nazar’,'% ta nazar’,'kelas’) ?>

تابع بعدی :

<?php comments_link() ?>

این تابع یکمی شبیه permalink_link هست یعنی لینک رو ایجاد نمیکنه فقط آدرس رو میده پس شما مجبورید بصورت دستی لینک رو بسازید ! ( توضیح دادم قبلا )

<?php comments_number() ?>

این تابع تعداد نظرات را برای پست نشان میدهد ، البته این تابع ۳ پارامتر هم میگیره که مثل ۳ پارامتر اول تابع comments_popup_link هستن.

توابعی که در فایل wp-comments.php قرار میگیرند :

<?php comment_author() ?>

اسم فرد نظردهنده را نمایش میدهد !

<?php comment_author_email() ?>

ایمیل فردنظردهنده را نمایش میدهد ! ( بصورت متن ساده )

<?php comment_author_url() ?>

آدرس فردنظردهنده را نمایش میدهد ! ( بصورت متن ساده )

<?php comment_author_email_link() ?>

ایمیل فردنظردهنده را نمایش میدهد ! ( بصورت لینک )

<?php comment_author_url_link() ?>

آدرس فردنظردهنده را نمایش میدهد ! ( بصورت لینک )

این دو تا تابع آخری که معرفی کردم ۳ تا پارامتر میگیرن :

• عبارتی که باید بصورت لینک در بیاد
• عبارتی که قبل از لینک نشون داده میشه ( بصورت متن ساده )
• عبارتی که بعد از لینک نشون داده میشه ( بصورت متن ساده )

<?php comment_author_IP() ?>

IP فرد نظردهنده را نمایش میدهد ( استفاده از این تابع توصیه نمیشود !!! )

<?php comment_text() ?>

متن نظر را نمایش میدهد

<?php comment_date() ?>

تاریخی که نظر در آن فرستاده شده نشان داده میشود

<?php comment_time() ?>

ساعت نظر دادن را نمایش میدهد

دو تابع آخر یدونه پارامتر هم میگیرن که مثل فرمت تابع Date هستن و هیچ فرقی ندارن !

<?php trackback_rdf() ?>

پیشنهاد میشو د این تابع را پس از تابع ()the_content استفاده کنید و آنرا بین علائم کامنت HTML جایگذاری کنید ! بصورت :

<!– <?php trackback_rdf() ?> –>

این تابع اطلاعات RDF بلاگ شما را نشون میده !

<?php trackback_url() ?>

این تابع آدرس دنبالک هر پست را نمایش میدهد !

توابع آرشیو Archives tag :

<?php get_archives() ?>

این تابع آرشیو را به نمایش در می‌آورد

پارامترها :

• نوع آرشیو که میتونه هر کدوم از انواع زیر باشه :
  • postbypost آرشیو رو بصورت مطلب به مطلب نشون میده
  • daily آرشیو رو بصورت روزانه نشون میده
  • weekly آرشیو هفتگی رو نمایش میده
  • monthly آرشیو ماهیانه رو نشون میده

  تمام مقادیری که در بالا آورده شد باید در پارامتر اول مورد استفاده قرار بگیره ! ( یعنی فقط یکیشون رو بنویسین توی اون تابع بدبخت تا قاطی نکنه ! )

• پارامتر دوم برای ایجاد محدودیت در نمایش تعداد لینکهاست ، یعنی با دادن عدد ۱۰ تابع فقط ۱۰ لینک آخر آرشیو رو نشون میده
• فرمت نمایش آرشیو ها :
  • html این مقدار لینکها رو در قالب <li> نشون میده ( این مقدار ، مقدار پیش‌فرض این پارامتر هم محسوب میشه )
  • option این مقدار آرشیو رو بصورت عناصر مورد استفاده در لیستهای بازشونده در می‌آره !
  • link این مقدار تگ <link> رو در هدر سایت ایجاد میکنه
  • custom با این وقدار میتونین عبارات دلخواهی رو قبل و بعد از لینکهای آرشیوتون نمایش بدین !
• عبارتی که میخواید قبل از لینک آرشیوتون نشون داده بشه
• عبارتی که میخواید بعد از لینک آرشیوتون نشون داده بشه
• این پارامتر فقط ۰ و ۱ را میپذیرد ، ۱ بمعنی اینه که تعداد پستهایی رو هم کنار لینک آرشیو نشون بده و ۰ هم یعنی هیچی نشون نده ! ( پیش‌فرض ۰ هست )

مثال : فرض کنید شما میخواید آرشیوی بسازید که بصورت ماهیانه باشه و فقط لینک ۳ ماه آخر رو نشون بده و قبل از لینک عبارت ++ و بعد از اون عبارت ** نشون داده بشه و تعداد پستها رو هم نشون بده ، بصورت زیر عمیل میکنیم :

<?php get_archives(’monthly’,'3′,’custom’,'++’,'**’,'1′) ?>

خروجی : ( مثلا )

++ December 2004 (13) **
++ November 2004 (20) **
++ October 2004 (5) **

تابع تقویم Calendar tag :

<?php get_calendar(); ?>

این تابع هم تقویم رو نشون میده ! ( مثل همین بقل دست راست )

امیدوارم این توضیحات مفید بوده باشه !
انسان جایزالخطاست و چون این مقاله نوشته‌ی دست انسانه پس نمیتونه خالی از ایراد و اشکال و.. باشه ؛ لطفا اگه ایرادی چیزی دیدین بهم از طریق ایمیل یا یاهو آیدیم اطلاع بدید تا تصحیحش کنم !
موفق باشید.