Създаване на WordPress plugin

Written by

in

,

В тази публикация ще опишем с няколко стъпки как може да напишиете WordPress plugin и Вие. Времето което е необходимо за прочитаме и усвояване на информацията е 15 минути.

Разширенията във WordPress позволяват лесно редактиране и персонализиране на вашият WordPress блог.  С разширенията на WordPress може да добавите нови функции без да е необходимо препрограмирането из основи на WordPress ядрото.

Преди да започнем с писането на WordPress pluginHelloWorld“ е необходимо да имате основни познания по WordPress Plugins :

1. Наименование на разширението

Първата задача преди да започнете да правите WordPress разширение или plugin е да му дадете име и да проверите в хранилището ви (/wp-content/plugins/) с разширения дали има наличен WordPress разширение с името което сте си избрали. Ако името на вашето разширение е уникално то тогава ви остава единствено да продължите напред 🙂 .

2. Директория на разширенията в WordPress
wordpress_plugin_directory1

В по- горния случай на изображението съответния плъгин се съхранява в директория, но това не е задължително. Ако конкретния плъгин се състои от единствен файл(както е нашият плъгин „HelloWorld„) то е възможно да бъде поместен директно във /wp-content/plugins/helloworld.php

3. Основна информация за разширението

/*
Plugin Name: HelloWorld
Plugin URI: http://www.mpetrov.net/write_wordpress_plugin_from_scratch
Description: Your First WordPress Plugin- Hello World
Author: Martin Petrov
Version: 0.75
Author URI: http://www.mpetrov.net/
*/

Сигурно забелязвате, че информацията се съхранява като коментар т.е. това не е php код за изпълнение, а просто за информация.

4. Лиценз  на разширението.

Повечето разширения са под лиценза GPL използван и от WordPress или от лиценз съвместим с GPL. За да посочите GPL лиценза като такъв трябва да добавите следните редове по- долу:

<?php

/*  Copyright YEAR  PLUGIN_AUTHOR_NAME  (email : PLUGIN AUTHOR EMAIL)

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the 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 of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
*/
?>

Преди версия 2.0 на WordPress, тези допълнителни визуални плъгини трябваше на ръка да бъдат кодирани в темата и по този начин владееното на PHP беше задължително. Във версия 2.0 и всяка следваща версия е въведена опцията „Widgets“ или „Джаджи“ от където може да добавяте и премахвате разширения (plugins) като всяка операция може да се извърши с Drag and Drop.

Разширението кеото ще създадем ще можем да менажираме от „Widgets“ или „Джаджи“ и когато го активираме ще излиза в sidebar на нашата тема.

Хайде да започнем с писането на нашият първи plugin за WordPress:

Първо трябва да създадем php файл които ще се казва: helloworld.php и ще го запишем в директория: /wp-content/plugins/ . В крайна сметка файла ще бъде ето тук: /wp-content/plugins/helloworld.php .  Може да използвате „vim„,“mcedit„,“nano„,“pico„,“vi“ и какъвто редактор решите.

След като създадохме празния файл-plugin е необходимо да добавим общата информация за него. Ето каква ще бъде информацията:

<?php
/*
Plugin Name: HelloWorld
Plugin URI: http://www.mpetrov.net/write_wordpress_plugin_from_scratch
Description: Your First WordPress Plugin- Hello World
Author: Martin Petrov
Version: 0.75
Author URI: http://www.mpetrov.net/
*/

?>

След това добавете основната функция HelloWorld() която ще извежда съобщението „Hello World. I’m your first WordPress plugin„:

<?php

function HelloWorld()
{
echo „<b><font color=’white’>He</font><font color=’green’>llo</font> <font color=’red’>World</font>. I’m your first WordPress plugin</b>“;
}

?>

Тук очевидно става ясно, че тази функция единствено извежда текст.

Сега добавете по- интересните функции:

<?php

function widget_HelloWorld($args)
{
extract($args);
echo $before_widget;
echo „$before_title <font color=’white’>Title</font> <font color=’green’>of</font> <font color=’red’>Widget</font> $after_title“;
HelloWorld();
echo $after_widget;
}
function HelloWorld_init()
{
register_sidebar_widget(„Hello World“,“widget_HelloWorld“);
}
add_action(„plugins_loaded“, „HelloWorld_init“);

Сега ще разгледаме функциите по отделно за да се изяснят действията които извършват. Първата функция widget_HelloWorld($args) е за това какво ще се показва в съответния sidebar (когато  плъгина е активиран в Widgets). Може би е добре да забележите , че първо извеждаме съобщение за заглавие и след това викаме функцията която по- рано написахме отново за извеждане на текст HelloWorld() .

Втората функция HelloWorld_init() се извиква когато WordPress плъгина е активиран. Той извиква WordPress функцията която ще регистрира новия Widget plugin които ще нарече „Hello World

Последния ред от плъгина добавя екшън, чрез които се казва на WordPress да извика HelloWorld_init() когато плъгина е зареден.

Това е кратко ръководоство което не може да покрие цялата информация относто създаването на Wordpress плъгини, но може да ви предостави основна информация. Надявам се, че информацията Ви е била полезна.

Приложение – файл: helloworld.php:

<?php
/*
Plugin Name: HelloWorld
Plugin URI: http://www.mpetrov.net/write_wordpress_plugin_from_scratch
Description: Your First WordPress Plugin- Hello World
Author: Martin Petrov
Version: 0.75
Author URI: http://www.mpetrov.net/
*/

function HelloWorld()
{
echo „<b><font color=’white’>He</font><font color=’green’>llo</font> <font color=’red’>World</font>. I’m your first WordPress plugin</b>“;
}

function widget_HelloWorld($args)
{
extract($args);
echo $before_widget;
echo „$before_title <font color=’white’>Title</font> <font color=’green’>of</font> <font color=’red’>Widget</font> $after_title“;
HelloWorld();
echo $after_widget;
}

function HelloWorld_init()
{
register_sidebar_widget(„Hello World“,“widget_HelloWorld“);
}

add_action(„plugins_loaded“, „HelloWorld_init“);
?>

Comments

5 responses to “Създаване на WordPress plugin”

  1. Аватарът на Vasil Dakov

    Много добра статия!

    1. Аватарът на admin

      Благодаря. Ако всеки които ползва WordPress по- задълбочено добави по едно изречение в тази статия то тя ще бъде доста добро ръководство за всички които тепърва започват да пишат плъгини за WordPress.

  2. Аватарът на Vasil Dakov

    Наистина е така. Единствено бих препоръчал използването на тага вместо , например:

    .white { color: white; }
    .green { color: green ; }
    .red { color: red; }

    echo „Hello World. I’m your first WordPress plugin“;

  3. Аватарът на admin

    В интерес на истината първоначално го бях направил с css, но предположих, че ще е най- четимо с прост html. Мисля, че си прав. Едва ли ще пише някои wordpress плъгини и няма да има и малко представа от CSS. В крайна сметка ДА това е добра забележка която мога единствено да приветствам .

  4. Аватарът на Gesh
    Gesh

    Евала статията е страшна следя блога постоянно !!!

Вашият коментар

Вашият имейл адрес няма да бъде публикуван. Задължителните полета са отбелязани с *