مستندات

فايل 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:(عدد صحیح، به طور پیش فرض 250) ،،  تعداد کاراکتر برای نشان دادن
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: (عدد صحیح ، به طور پیش فرض : سال جاری) ،، اگر یک سال قبل از فعلی داده می شود آن را قبل از یکی از سالهای جاری (2012 — 2011) نشان میدهد.
Separator: (رشته ، به طور پیش فرض : “–“) ،، متن مورد استفاده برای جدا کردن سال (در مورد یک سال قبل اعلام میشه).
Tail: (رشته، به طور پیش فرض. “کلیه حقوق این سایت متعلق به است.”) ،، متن نشان می دهد پس از اطلاعات کپی رایت قرار دارد.

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

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