مستندات

فایل Functions.php


این مقاله کامل نیست ، برای کاملتر شدن آن لطفا صبر کنید ..

فایل Functions.php در بیشتر پوسته‌های وردپرس وجود دارد که در آن توسعه دهندگان و طراحان پوسته می‌توانند عملکرد‌های خودشون رو اضافه کنند .. این فایل مانند یک افزونه ( پلاگین ) عمل می کند و می‌توان بصورت خودکار در لود اولیه بارگذاری وردپرس ازش کرد و به وسیله‌ی آن تغییراتی قابل توجه در قالب ایجاد کرد و امکانات پوسته و وردپرس رو افزایش داد ..

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

ساخت فایل

اگر پوسته‌ی شما دارای این فایل نیست برای ایجاد آن یک فایل متنی در یک ویرایشگر متن باز کنید و آن را با نام و پسوند functions.php ذخیره کنید و سپس فایل رو به داخل پوشه‌ی پوستتون منتقل کنید ..

نکته : هیچ گاه از نرم افزار های ویراستار متن مانند Microsoft Word برای ویرایش فایلهای وردپرس استفاده نکنید!

نکته مهمتر:مبحث Functions بسیار گسترده هستش و امکانات بسیار زیادی داره که بهتره در یک مقاله منتشر نشه ، در اینجا من به تعدادی مثال در این باره میپردازم برای آشنایی دوستان تا در بعدها طی مقالات و مباحثی جدا به معرفی و بررسی امکانات Functions.php بپردازیم و حتما در این صورت بهتر خواهد بود ..

استفاده از فایل

مخفی کردن نگارش وردپرس

اگر دقت کرده باشید نگارش و نوع مدیریت محتوای سایت شما از روی مرورگر قابل تشخص هستش ، برای مثال در مرورگر فایرفاکس در مسیر Tools/Page Info نوع نگارش وردپرس شما مشخص میشه ، برای حذف این نگارش از دید مرورگر‌ها و کاربران از تابع زیر در فایل functions استفاده میکنیم ..

این فایل رو در قالب جاری باز کنید و این کد‌ رو اضافه کنید ..

remove_action('wp_header', 'wp_generator');

حذف همین اطلاعات از بخش RSS سایت ،

function wpt_remove_version() {
return '';
}
add_filter('the_generator', 'wpt_remove_version');

تابع سفارشی به لیست پست های اخیر

نمایش آخرین مطالب مربوطه در سایت

wp_list_recent_posts( Amount, Categories, HTML before, HTML after );

استفاده از تابع :

<ul>
// gets 10 recent posts from all categories except category 5.
<?php if ( function_exists( 'wp_list_recent_posts' ) ) wp_list_recent_posts( 10, '-5' ); ?>
</ul>

تابع سفارشی برای کوتاه کردن محتوای پست بر اساس کارکتر

shorten_text( Characters, Tail, Print );

Characters:(عدد صحیح، به طور پیش فرض ۲۵۰) ،،  تعداد کاراکتر برای نشان دادن
Tail: (رشته، به طور پیش فرض “…”) ،، بعد از اتمام تعداد کارکتر‌ها نشان میدهد ..
Print: ( به طور پیش فرض : درست است) ،، نسخه قابل چاپ لیست و یا بازگشت آن برای PHP

استفاده از تابع :

// wordpress loop
<?php   while (have_posts()) : the_post(); ?>
<h1><?php the_title(); ?></h1>
<div>
// will shorten text after 150 characters
<?php if ( function_exists( 'shorten_text' ) ) shorten_text( 150 ); ?>
</div>
<?php  endwhile; ?>

تابع سفارشی برای نمایش بخش هایی برجسته از نظر نویسنده

highlight_comment( Class Name, Author ID );

Class Name:  نام کلاس CSS مورد نظر است
Author ID: آیدی کاربر نویسنده است

استفاده از تابع :

// Comments Loop
<?php foreach ($comments as $comment) : ?>
<li id="comment-<?php comment_ID() ?>">
...
?>

تابع سفارشی که اطلاعات مربوط به کپی رایت پویا را نشان می دهد

display_copyright( Year, Separator, Tail );

Year: (عدد صحیح ، به طور پیش فرض : سال جاری) ،، اگر یک سال قبل از فعلی داده می شود آن را قبل از یکی از سالهای جاری (۲۰۱۲ — ۲۰۱۱) نشان میدهد.
Separator: (رشته ، به طور پیش فرض : “–“) ،، متن مورد استفاده برای جدا کردن سال (در مورد یک سال قبل اعلام میشه).
Tail: (رشته، به طور پیش فرض. “کلیه حقوق این سایت متعلق به است.”) ،، متن نشان می دهد پس از اطلاعات کپی رایت قرار دارد.

استفاده از تابع :

<?php if ( function_exists( 'display_copyright' ) ) display_copyright(); ?>
// will display: <div id="copyright">© ۲۰۱۱٫ Blog Name. All rights reserved.</div>
<?php if ( function_exists( 'display_copyright' ) ) display_copyright( 2011, ' to ', '. Some rights reserved.' ); ?>
// will display: <div id="copyright">© ۲۰۰۶ to 2008. Blog Name. Some rights reserved.</div>