مقدمه

یکی از نقاط قدرت وردپرس افزونه‌های آن است که قابلیت‌ها و توانایی‌های آن را افزایش میدهد. وردپرس این امکان را به هر کاربری با کمی معلومات میدهد تا افزونه خود را بنویسد و بصورت شخصی استفاده کند یا با دیگران به اشتراک بگذارد.
برای نوشتن یک افزونه وردپرس کافیست اطلاعاتی مقدماتی در PHP, JavaScript و CSS داشته باشید.

چرا باید یک افزونه وردپرس بنویسیم؟

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

شروع

هر افزونه وردپرس باید حداقل دارای یک فایل PHP باشد، همچنین میتواند دارای فایل‌های دیگر شامل فایل‌های جاوا اسکریپت، فایل‌های استایل، عکس و… باشد، به همین دلیل بهتر است برای افزونه خود یک پوشه ایجاد کنیم.
برای شروع در مسیر wp-content/plugins یک پوشه همنام با افزونه خود ایجاد میکنیم، نام این پوشه نباید شامل فاصله (space) باشد، برای این آموزش من پوشه‌ی myPlugin را ایجاد میکنم.
درون این پوشه یک فایل PHP ایجاد میکنیم همنام با نامِ پوشه، اگر با درست کردن قالب‌های وردپرس آشنا باشید میدانید که برای اینکه وردپرس قالب شما را بشناسد باید در چند خط اول فایل style.css مشخصات قالب را وارد کنیم، در نوشتن افزونه نیز باید همین کار را انجام دهیم، بنابراین چند خط اول این فایل به مشخصات افزونه اختصاص دارد.

<?php
/*
Plugin Name: Name Of The Plugin
Plugin URI: http://URI_Of_Page_Describing_Plugin_and_Updates
Description: A brief description of the Plugin.
Version: The Plugin's Version Number, e.g.: 1.0
Author: Name Of The Plugin Author
Author URI: http://URI_Of_The_Plugin_Author
*/
?>

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

نکته بسیار مهمی که باید به آن توجه داشته باشید این است که Encoding این فایل باید ANSI باشد، اگر این فایل را بصورت UTF-8 یا فرمت‌های دیگر ذخیره کنید هنگام راه‌اندازی یا استفاده از افزونه با خطای :

Warning: Cannot modify header information

مواجه خواهید شد. برای تغییر Encoding فایل میتوانید در برنامه Notepad++ از منوی Format گزینه Encoding in ANSI را انتخاب کنید مانند تصویر زیر:

یا از UTF-8 without BOM استفاده کنید.
حال که فایل که خود آماده و ذخیره کردیم میتوانید وارد صفحه مدیریت افزونه‌های وردپرس شویم، اگر تمام کارها را درست انجام داده باشیم افزونه‌ای که درست کردیم را در لیست افزونه خواهیم دید.

استفاده از توابع Hook

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

یکی از این توابع تابع register_activation_hook میباشد، این تابع دو ورودی دریافت میکند، ورودی اول مسیری است که فایل PHP اصلی افزونه در آن قرار دارد، و ورودی دوم تابعی است که باید اجرا کند.
کار این تابع این است که تابعی که به عنوان ورودی دریافت میکند را هنگامی که افزونه فعال میشود اجرا کند، برای مثال به کد زیر توجه کنید:

register_activation_hook(__FILE__, 'myPlugin_activate');

function myPlugin_activate() {
 // do something...
}

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

تابع دیگر register_deactivation_hook میباشد که مانند تابع قبل دو ورودی میگیرد و تابع‌ای که به آن معرفی میشود را هنگام غیرفعال کردن افزونه اجرا میکند.

به جز تو تابع بالا توابع hook به دو دسته تقسیم میشوند:
Actions : وقتی یک رویداد خاص اتفاق میفتد یا در زمان خاصی اجرا میشوند.
Filters : برای انجام تغییراتی روی اطلاعات قبل ارسال به پایگاه داده یا نمایش استفاده میشوند.

گاهی میتواند یک کار را هم با استفاده از Actionها انجام داد هم Filterها.

Actions

برای استفاده از actionها کافیست یک تابع PHP که میخواهید اجرا شود بنویسید، سپس آن را در زمانی که میخواهید توسط تابع add_action اجرا کنید.

add_action ('plugins_loaded', 'plugin_start');

function plugin_start() {
 if ( is_admin() ) { } else {
 wp_enqueue_script ("jquery");
 require_once (dirname (__FILE__) . "/functions.php");
 }
}

برای مثال در تکه کد بالا مشاهده میکنید که یک تابع با نام plugin_start نوشته شده است، سپس توسط تابع add_action در زمان plugins_loaded فراخوانی شده است، در این صورت تابع plugin_start در زمانی که افزونه‌ها بطور کامل بارگذاری شده‌اند اجرا میشود و کتابخانه جاوا اسکریپت jQuery موجود در هسته وردپرس و فایل functions.php موجود در پوشه افزونه را فراخوانی میکند.

یا برای مثال میتوانید تابعی به اسم email_friends بنویسید و آن را در زمان publish_post فراخوانی کنید، در این صورت زمانی که پست شما منتشر میشود تابع email_friends اجرا میشود و آن را برای تمام دوستان شما ارسال میکند.

میتوانید لیستی از hookهایی که میتوانید در آنها از تابع add_action استفاده کنید را در این صفحه ببینید.

Filters

فیلترها نیز مانند actionها کار میکنند، فقط باید یک تابع بنویسید و آن را به زمانی که میخواهید اجرا شود به وسیله تابع add_filter اختصاص دهید.

add_filter('comment_text','filter_profanity');

function filter_profanity($content) {
 global $profanities;
 $content=str_ireplace($profanities,'{censored}',$content);
 return $content;
}

برای مثال در کد بالا تابع filter_profanity نوشته شده و یک ورودی content میگیرد و با متغییر profanities از قبل تعریف شده مقایسه میکند و اگر کلمه‌ای متشابه داشته باشد آن را با {censored} جایگزین میکند، این تابع به comment_text اختصاص داده شده و به این ترتیب متن دیدگاه‌هارا بررسی میکند اگر در آن ناسزا بکار برده شده باشد آن را سانسور میکند.

میتوانید لیستی از hookهایی که میتوانید در آنها از تابع add_filter استفاده کنید را در این صفحه ببینید.

نمونه

در آخر افزونه myPlugin را این صورت کامل میکنیم:

<?php
/*
Plugin Name: myPlugin
Plugin URI: http://www.radikal2.com/
Description: it is my first wordpress plugin
Version: 1.0
Author: Radikal2
Author URI: http://www.radikal2.com
*/

add_action ('publish_post', 'myPlugin_email');
add_filter ('the_title', 'myPlugin_title');

function myPlugin_email($post_ID) {
 $mails = 'you-name@your-domain.com,you-name@your-domain.com,you-name@your-domain.com,';
 mail($mails, "My Blog Updated!",
 'I just put something on my blog: http://blog.example.com');
 return $post_ID;
}

function myPlugin_title($t) {
 $x = '<span style="text-shadow: 0px 0px 16px blue;">' .$t. '</span>';
 return $x;
}

?>

مشاهده میکنیم که در این کد از دو تابع add_action برای فراخوانی تابع myPlugin_email برای ارسال یک ایمیل برای تعدادی از دوستان بعد از انتشار پست و add_filter برای اضافه کردن افکت سایه به کمک یک کد CSS به تیتر مطالب استفاده شده است.

+ Writing a Plugin / Plugin API

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

بعد از این یک نوار بالای صفحه نمایش شما ظاهر میشود که با کلیک بر روی دکمه Start Recording فیلم‌برداری از صفحه نمایش شروع میشود.
بعد از اینکه کارتان تمام شد روی نوار نارنجی‌رنگ بالای صفحه کلیک میکنید و فیلم‌برداری متوقف میشود، سپس میتوانید با کلیک بر روی دکمه Continue Recording به ضبط ادامه بدهید یا روی Finish this screencast کلیک کنید و در مرحله بعد قادر خواهید بود با کلیک روی Preview this screencast یک پیش نمایش از فیلم ضبط شده را مشاهده کنید و با کلیک روی Save this screencast فیلم را روی سایت ScreenCastle آپلود کنید.

بعد از آپلود شدن ویدئو، سایت به شما چندین لینک میدهد از جمله لینک مستقیم برای دانلود ویدئو با فرمت Flv، لینک به صفحه پلیر ویدئو، لینک برای قرار دادن ویدئو در سایت یا وبلاگ و دو لینک تصویر پیش نمایش ویدئو در سایز بزرگ و کوچک و…

در زیر یک نمونه از ویدئوی که به کمک این سایت تهیه کرده‌ام را میتوانید ببینید:

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

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

<div id="container">
<div class="percent"></div>
<div class="bar"></div>
</div>

المنت div کلی با آی‌دی container بدنه اصلی نوار را ایجاد میکند، المنت با کلاس percent درصد نوار را نمایش میدهد که میتوانید به دلخواه آن را حذف کنید و المنت بعدی با کلاس bar قسمت رنگی نوار را تشکیل میدهد که مقدار پر شده‌ی نوار را مشخص میکند.

بعد از این نوبت به نوشتن کد CSS میرسد:

#container {
background: #F0F0F0;
width: 200px;
height: 20px;
position: relative;
}
#container .percent {
text-align: center;
position: absolute;
width: 200px;
height: 20px;
top: 12%;
font: 12px Tahoma, Geneva, sans-serif;
}
#container .bar {
background: #3C0;
height: 20px;
}

مشخصه width دو المنت اول باید یکی باشد و مشخصه height هرسه المنت باید یکی باشد.

حالا کد اول را بصورت زیر تغییر میدهیم :

<div id="container">
<div class="percent">65%</div>
<div class="bar" style="width: 65%;"></div>
</div>

با تغییر دادن درصد مشخصه width میزان پر شدن نوار را مشخص میکنیم، حالا میتوانیم این درصد را به کمک یه زبان مانند php یا javascript تعیین کنیم و یا این کار را دستی انجام دهیم.

دسکتاپ استاندارد ویندوز خود را به یک دسکتاپ ۳۶۰ درجه وسیع تبدیل کنید و محیط بازتری برای کار در دسکتاپ خود داشته باشید.
همچنین میتوانید با برنامه ۳۶۰Desktop ابزارک‌های مختلف از سایت‌های مورد علاقه خود را در دسکتاپتان قرار دهید و تصاویر پس‌زمینه ۳۶۰ درجه خود را بسازید و با دیگر کاربران این برنامه به اشتراک بگذارید.

با نصب برنامه ۳۶۰Desktop دسکتاپ ویندوز شما وسیع‌تر میشود و قادر خواهید بود در دسکتاپ خود بچرخید و در هر قسمت آن کار جداگانه‌ای انجام دهید. با اضافه کردن ابزارک‌های مختلف آخرین اخبار را روی دسکتاپ خود داشته باشید، از آخرین مطالب وبلاگ‌ها به کمک RSS آگاه شوید، بازی‌های کوچک و جذاب را روی دسکتاپتان داشته باشید و …

همچنین میتوانید از قسمت گالری سایت برنامه تصاویر پس‌زمینه زیبای ۳۶۰ درجه را به برنامه اضافه کنید.

در ویدئو زیر هم میتوانید طریقه کار برنامه را مشاهده کنید :

+ یک ویدئو دیگر

برای دانلود کردن برنامه به سایت آن مراجعه کنید

این اولین آموزش ویدوئی این وبلاگ بود، خوشحال میشم نظرات شما را راجع به این کار بدونم.

+ لینک ویدئو در سایت یوتوب

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

کد زیر را در قالب خود قرار دهید

<?php
$numposts = $wpdb->get_var("SELECT COUNT(*) FROM $wpdb->posts WHERE post_status = 'publish' AND post_type = 'post'");
if (0 < $numposts) $numposts = number_format($numposts);

$numcomms = $wpdb->get_var("SELECT COUNT(*) FROM $wpdb->comments WHERE comment_approved = '1'");
if (0 < $numcomms) $numcomms = number_format($numcomms);

$numcats = $wpdb->get_var("SELECT COUNT(*) FROM $wpdb->term_taxonomy WHERE taxonomy = 'category'");
if (0 < $numcats) $numcats = number_format($numcats);

$numtags = $wpdb->get_var("SELECT COUNT(*) FROM $wpdb->term_taxonomy WHERE taxonomy = 'post_tag'");
if (0 < $numtags) $numtags = number_format($numtags);
?>

حالا متغییر numposts$ تعداد پست‌ها، متغییر numcomms$ تعداد نظرها، متغییر numcats$ تعداد دسته‌بندی‌ها و متغییر numtags$ تعداد برچسب‌ها را در خود نگهداری میکنند و میتوانید به راحتی از آنها در قالب خود استفاده کنید.

Total posts: <?php echo $numposts; ?>
Total comments: <?php echo $numcomms; ?>
Total Categories: <?php echo $numcats; ?>
Total Tags: <?php echo $numtags; ?>

در یکی از پست‌های قبلی با عنوان “یک راه زیبا برای نمایش تعداد خوانندگان فید” روشی را معرفی کرده بودم که به کمک آن میتوانستیم تعداد خوانندگان فید خود را بصورت متنی و خارج از قالب پیش فرض فیدبرنر نمایش دهیم.

اما با توجه به تغییراتی که گوگل در سایت فیدبرنر ایجاد کرد و فید‌های این سرویس را به آدرس جدید انتقال داد، API این سرویس هم بروز شد و به کلی تغییر کرد، به همین دلیل اسکریپتی که قبلا معرفی کرده بودم دیگر کارایی ندارد.

اما امروز بعد از کمی ور رفتن با API جدید فیدبرنر توانستم راه تازه‌ای برای نمایش خوانندگان فید بدست بیاورم.

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

سپس فایل fetch.php را با یک ویرایشگر متن باز کرده و در مقابل id$ بجای YOUR_FEED_ID  آی دی فید مورد نظر خود را قرار دهید.
برای بدست آوردن آی دی فید میتوانید مثل قبل به داشبورد فیدبرنر در آدرس جدیدش بروید روی فید مورد نظر کلیک کنید و عبارت روبروی id در نوار آدرس مرورگر را کپی کنید.

بعد از این فقط کافیست مانند قبل بکمک تگ Script فایل js.php را در صفحه جایی که دوست دارید قرار دهید.

توجه داشته باشید که حتما Awareness API را که در مرحله اول نوشته قبلی توضیح داده شده بود فعال کنید، اگر هنگام فعال کردن این خاصیت با خطایی مواجه شدید که میگوید شناسه Delicious شما غلط است مجبورید دلیشز را غیر فعال کنید.

برای برقراری امنیت در فرم‌ها از یکی از نقطه ضعف‌های برنامه‌های کامپیوتری استفاده شده و آن هم قدرت تشخیص پایین است.
روشی که برای این کار وجود دارد کپچا (CAPTCHA) نام گرفته که مخفف کلامات “Completely Automated Public Turing test to tell Computers and Humans Apart” میباشد به معنای “تست کاملا خودکار عمومی تورینگ برای جداسازی کامپیوتر از انسان”.
اساس کار کپچا این است که آزمونی طراحی میکند که مطمئن است کامپیوتر‌های دیگر قادر به حل آن نیستند. متداولترین نوع کپچا تصویری از کاراکتر‌های بهم ریخته است که از کاربر میخواهد تا آن کاراکتر‌ها را تشخیص دهد، این نوع کپچا است که در سایت‌ها مورد استفاده قرار میگیرد.

روزانه ۲۰۰ میلیون کپچا در همه‌جای دنیا توسط کابران حل میشود که هرکدام بطور متسوط ۱۰ ثانیه از وقت انسان را میگیرد، ممکن است این زمان زیادی نباشد ولی در کل روزانه ۱۵۰۰۰۰ ساعت از وقت کاری انسان‌ها را تلف میکند.
بوجود آورندگان واژه کپچا در سال ۲۰۰۰ امروز پیشنهاد میکنند که از reCAPTCHA استفاده شود، اما کار ری‌کپچا چیست؟
ری‌کپچا با بوجود آوردن آزمون‌های کپچا در عین حال که امنیت فرم‌های الکترونیک را بالا میبرد به گسترش کتاب‌ها و آرشیو‌های الکترونیکی کتاب‌های چاپی و روزنامه‌های قدیمی کمک میکند، اما چگونه؟

حجم زیادی از کتاب‌ها و مجله‌ها قبل از دوران کامپیوتر بوجود آمده‌اند و نسخه الکترونیک ندارند، این کتاب‌ها توسط اسکنر‌ها اسکن شده و داخل کامپیوتر ذخیره میشوند سپس توسط برنامه‌های OCR خوانده شده و به متن دیجیتال تبدیل میشوند، اما با تکنولوژی امروز برنامه‌های OCR قابلیت تشخیص تمام کلمات را بخوبی دارا نیستند.

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

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

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

مرتبط :
+ کپچا «تو آدمی؟»
+ کپچا در خدمت بشریت
+ کپچا چیست؟