Бетке Сергей: iT блог

С этой статьи начну цикл по написанию собственного плагина для wordpress 3.0. Решил разбить на несколько статей по одной причине – слишком долго писать буду :-). Итак – создаём php файл плагина.

Поможет нам в этом вполне официальный рецепт “Написание плагина”. Что же нам рекомендует codex? Приведу часть кода одного из самых простых плагинов – RusToLat.

<?php
/*
Plugin Name: RusToLat
Plugin URI: http://mywordpress.ru/plugins/rustolat/
Description: This plugin converts Cyrillic characters in post slugs to Latin characters…
Author: Anton Skorobogatov <skorobogatov@gmail.com>
Contributor: Andrey Serebryakov <saahov@gmail.com>
Contributor: Sergey Biryukov <sergeybiryukov.ru@gmail.com>
Author URI: http://skorobogatov.ru/
Version: 0.3
*/ 
?>

Да простит меня автор за цитирование его кода. Суть в том, что данный заголовок – далеко не блажь. Из официального рецепта “Написание плагина” следует, что комментарий в начале файла быть обязан и должен иметь конкретную структуру. Именно указанные в этом комментарии “реквизиты” и фигурируют в консоли wordpress в разделе “Плагины”.

Итак, формируем заголовок для собственного плагина:

<?php 
/*
Plugin Name: COS Search provider
Plugin URI: http://sergey-s-betke.blogs.novgaro.ru/ie-search-provider-wordpress-plugin/
Description:This plugin add link teg for search descriptor.
Version: 1.0
Author: Sergey S. Betke
Author URI: http://sergey-s-betke.blogs.novgaro.ru/
License: GPL2
Copyright 2010 Sergey S. Betke (email : sergey.s.betke@novgaro.ru)
This program is free software;
you can redistribute it and/or modifyit under the terms
of the GNU General Public License as published bythe
Free Software Foundation; either version 2 of the License,
or(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY;
without even the implied warranty ofMERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE.
See theGNU General Public License for more details.
You should have received a copy of the GNU General
Public Licensealong with this program;
if not, write to the Free SoftwareFoundation, Inc.,
59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
*/
?>

Мы также дописали лицензию, что рекомендуется кодексом. Для изучения GPL рекомендую кодекс, Википедию и перевод лицензии на русский язык.

Теперь нам необходимо сохранить файл php. По кодексу следует помнить следующие постулаты:

• все файлы плагина располагаются в каталоге плагина и его подкаталогах;
• каталог плагина размещается в каталоге wp-content/plugins/;
• каталог плагина должен иметь уникальное именование. И его уникальность – Ваша задача;
• в каталоге плагина должен располагаться ОДИН php файл, причём его следует именовать также, как и каталог (почему – станет понятным из следующих статей);

Читаем дальше…