مستندات

توابع پوسته » کالبدشکافی تابع پوسته


مقدمه

در مقاله حاضر به بررسی کوتاه و مختصر موجودی موسوم به [[تابع پوسته]] وردپرس می پردازیم تا بتوانیم به کسانی که آشنایی چندانی با وردپرس و [[پی اچ پی|PHP]] ندارند کمکی کرده باشیم و آن ها را با توابع پوسته و کاربرد آن ها آشنا کنیم.

همه توابع پوسته وردپرس از سه جزء ساخته شده اند:

  • یک تابع کد پی اچ پی
  • یک دستورالعمل وردپرس
  • پارامترهای اختیاری

در ادامه توضیحی درباره این اجزا ارائه می شود.

تابع کد پی اچ پی

وردپرس با استفاده از زبان نوشتاری [[پی اچ پی|PHP]] ساخته شده است. برای استفاده از وردپرس لازم نیست خودتان [[پی اچ پی|PHP]] نویس باشید اما با این حال آشنایی هر چند اندک با این زبان به شما کمک می کند تا بتوانید به بهترین نحو از وردپرس استفاده کنید. در این بخش اطلاعاتی بسیار اندک در مورد [[پی اچ پی|PHP]] ارائه خواهیم نمود:

<?php ?>

کد بالا عناصر آغازین (<?php) و پایانی (?>) توابعی را نشان می دهد که برای قرار دادن دستورالعمل ها و کد [[پی اچ پی|PHP]] در اسناد [[اچ تی ام ال|HTML]] مثلا صفحات وب از آن ها استفاده می شود. راه های مختلفی برای قرار دادن کد [[پی اچ پی|PHP]] در صفحات وجود دارد. اما این راه “قالبیت انتقال” بالاتری نسبت به سایر روش ها دارد چرا که تقریبا بر روی همه [[وب سرور|Web Server]]هایی که زبان [[پی اچ پی|PHP]] را پشتیبانی می کنند، کار می کند (معمولا نام پرونده باید به پسوند php. ختم شود تا سرور آن را به عنوان سند [[پی اچ پی|PHP]] بشناسد).

هر آن چه در داخل این تابع قرار دارد به وسیله مفسر [[پی اچ پی|PHP]] وب سرور تجزیه و تحلیل می شود (مفسر یک موتور پی اچ پی است که ابتدا دستورالعمل ها و کدهای محتلف و کار آن ها را تشخیص می دهد و سپس نتیجه را گزارش می دهد). در وردپرس تابع [[پی اچ پی|PHP]] این امکان را فراهم می آورد تا دستورالعمل های وردپرس را در پوسته صفحه قرار دهیم و از این طریق بخش های پویای وبلاگ را راه اندازی کنیم.

دستورالعمل وردپرس

دستورالعمل وردپرس یا تابع دستورالعملی از نوع [[پی اچ پی|PHP]] است که کاری را انجام می دهد و یا اطلاعاتی را به صورت ویژه برای وبلاگ شما به نمایش می گذارد. دستورالعمل وردپرس مانند دسورالعمل [[پی اچ پی|PHP]] با متن نوشتاری (شامل یک یا چند واژه که پشت سر هم بدون فاصله نوشته شده اند)، هلال (پرانتز) و اغلب یک نقطه ویرگول در پایان کد، قابل شناسایی است. نمونه ای از یک دستورالعمل وردپرس را در زیر می بینید:

the_ID();

the_ID() عدد مربوط به شناسه نوشته در وبلاگ را به نمایش می گذارد. برای استفاده از این دسورالعمل در تابع صفحه باید آن را در تابع پی اچ پی که در بالا به ان اشاره شد قرار داد:

<?php the_ID(); ?>

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

پارامترهای اختیاری

آخرین بخش سازنده بک تابع پوسته بخشی است که فقط در صورت شخصی سازی قابلیت های تابع از آن استفاده می شود و در غیر این صورت نیازی به آن نیست. این جزء که بهتر است آن را به صورت جمع به کار ببریم پارامترها یا استدلالات دستورالعمل مربوطه هستند. در اینجا دستورالعمل تابع [[bloginfo()]] را مشاهده می کنید که پارامتر “show” در ارزش 'name' آن قرار دارد.

<?php bloginfo('name'); ?>

اگر نام وبلاگ شما “Super Weblog” باشد، هر گاه از 'name' به عنوان ارزش پارامتر “show” استفاده کنید نام وبلاگ همانچایی که در تابع صفحه قرار داده شده است، به نمایش در می آید.

همه توابع پوسته پارامتر نمی پذیرند ( تابع _ID() یکی از آن هاست). آن دسته از توابعی هم که پارامتر می پذیرند بر اساس کاربرد و نوع استفاده پارامترها را قبول می کنند. بنابراین پارامترهایی که تابع [[the_content()]] می پذیرد با پارامترهایی که تابع [[get_calendar()]] می پذیرد متفاوت است.

مطالعه بیشتر

برای کسب اطلاعات بیشتر درباره توابع وردپرس و توابع پوسته به صفحات زیر در بخش مستندات مراجعه کنید:

[[توابع]]
[[چگونگی همخوانی با پارامترهای تابع]]