• Создание простейшего плагина с сокращенным кодом (Shortcode), который вставляет в запись блога ссылку на внешний сайт с тегом <noindex> и атрибутом rel="nofollow".
• Создание плагина с использованием функции WordPress add_action, который добавляет в заданное место на странице случайно выбранную фразу.

рассматриваются базовые понятия и приемы, используемые при создании плагинов WordPress. Следующий шаг – это сделать так, чтобы плагин хранил все необходимые текстовые данные не внутри php-файла, а в базе данных. Это позволит добавлять новые данные, не изменяя файл(ы) плагина.

Хранение данных плагина в базе данных WordPress

Плагин может записывать в базу данных:

• Настройки- то, что выбирает пользователь, когда устанавливает плагин. Такие данные обычно сохраняют с использованием механизма опций WordPress options mechanism.
• Данные - информация, добавляемая в процессе работы плагина, которая обычно связана с отдельными записями, категориями и т.д.. Данные можно хранить в отдельной таблице базы данных MySQL, которую нужно для этого создать. Также можно хранить данные как метаданные записей, так называемые пользовательские поля (Custom Fields) (WordPress' Post Meta).

Обычно плагин автоматически создает таблицу в базе данных MySQL для хранения данных (это должно происходить во время установки плагина, или пользователь может выполнить соответствующий SQL-запрос в phpMyAdmin).
Для того чтобы автоматически создавать и обновлять таблицу базы данных:

• Нужна PHP-функция, которая создает таблицу базы данных.
• Нужна PHP-функция обновления на случай, если для новой версии плагина потребуется таблица базы данных с другой структурой.
• WordPress должен вызывать эти функции при активации/обновлении плагина.

Создание таблицы базы данных

Итак, пишем функцию с именем tbl_install, которая создает таблицу базы данных.
Префикс таблицы базы данных
В файле wp-config.php владелец сайта WordPress может определить префикс базы данных WordPress  (по умолчанию это wp_). Применяемое значение префикса хранится в переменной $wpdb->prefix. (В WordPress до версии 2.1 это значение хранилось в переменной $table_prefix).
Сначала задаем имя таблицы базы данных с именем tblname:

function tbl_install () {
global $wpdb;
$table_name = $wpdb->prefix . "tblname";

Попытка найти таблицу с именем $table_name с помощью SQL-запроса SHOW TABLES (проверяем существование такой таблицы):

if($wpdb->get_var("SHOW TABLES LIKE '$table_name'") != $table_name) {

Если этой таблицы еще нет, ее нужно создать.
Создать таблицу можно с помощью прямого SQL-запроса или с помощью функции dbDelta
из файла wp-admin/includes/upgrade.php (этот файл нужно загрузить, т.к. по умолчанию он не загружается). Функция  dbDelta сравнивает текущую структуру таблицы с требуемой структурой и добавляет или изменяет эту структуру, поэтому она используется для обновлений.  (Примеры
использования функции dbDelta можно посмотреть в файле wp-admin/upgrade-schema.php).
При использовании функции dbDelta имейте в виду, что

• Каждое поле в SQL-выражении должно располагаться на отдельной строке.
• Между словами PRIMARY KEY и определением первичного ключа должно быть два пробела
• Нужно использовать ключевое слово KEY, а не его синоним INDEX, и должен быть задан, по крайней мере, один ключ KEY.

Итак, создание или обновление таблицы:

$sql = "CREATE TABLE " . $table_name . " (
             id mediumint(9) NOT NULL AUTO_INCREMENT,
             time bigint(11) DEFAULT '0' NOT NULL,
             name tinytext NOT NULL COLLATE utf8_general_ci,
             text text NOT NULL COLLATE utf8_general_ci,
             url VARCHAR(55) NOT NULL COLLATE utf8_general_ci,
             UNIQUE KEY id (id)
          );";

require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
dbDelta($sql);

Будет создана такая таблица:

Таблица базы данных

В этой таблице для плагина, который добавляет в заданное место на странице случайно выбранную фразу, можно хранить фразы (text), а также время добавления и имена пользователей, которые добавили фразы.
Типы данных:
MEDIUMINT – целые числа от -8 388 608 до 8 388 607
BIGINT – целые числа от -9 223 372 036 854 775 808 до 9 223 372 036 854 775 807
TINYTEXT - не более 255 символов
TEXT – не более 65 535 символов
VARCHAR - не более 255 символов.
(в скобках указывается заявленное максимальное количество символов)

Модификаторы:
NOT NULL – поле должно быть явно инициализировано, т.е. не может содержать неопределенное значение
AUTO_INCREMENT – при добавлении в таблицу новой записи значение этого поля будет автоматически увеличиваться на 1
DEFAULT – задает значение, используемое по умолчанию, когда значение явно не задано
COLLATE utf8_general_ci – задает сравнение (или сопоставление, collation)
UNIQUE KEY – уникальный ключ
***
Продолжение скоро последует …

Wordpress формирует два RSS-потока: поток записей и поток комментариев. Практически во всех темах Wordpress вы видите характерный значок, щелкнув на котором, посетители могут подписаться на ваш блог, чтобы узнавать о появлении новых записей с помощью одного из RSS-агрегаторов.
RSS-потоки можно направлять через Feedburner, чтобы отслеживать количество подписчиков. Feedburner также поддерживает подписку на блог по email и всякие полезности, например, Аниматор заголовков, который создает рекламный баннер, поочередно показывающий заголовки пяти последних записей из фида. Вот такой баннер  получился у моего сайта для изучающих английский язык:

↑ Получить этот Аниматор заголовков

Фид FeedBurner и его настройка

После регистрации можно выбрать русский язык (в Languages)

| Мои фиды | Моя учетная запись | Languages | Help | Выйти

На странице фидов введите адрес своего блога (Feedburner найдет фиды блога) и идите  дальше (Next).

Для любого из доступных на вашем блоге  фидов вы можете создать фид Feedburner. Вы получите его адрес вида http://feeds.feedburner.com/имя-фида. Это адрес страницы, через которую посетители должны подписываться на ваш блог, чтобы их можно было посчитать.
Эту страницу надо настроить для русской аудитории, поэтому переходите к управлению фидом Оптимизируй->BrowserFriendly и выберите русскую Тему:

Тема фида

Выбирайте остальные настройки и не забудте их сохранить!

Подписка по email

Зайдите в Публикуй->Подписки по электронной почте. Дальше по инструкции (на русском языке).

Счетчик

Зайдите в Публикуй->FeedCount.
Счетчик FeedCount динамически отображает количество подписчиков на фид и является ссылкой на страницу подписки на фид. Активируйте счетчик, выберите для него цвет и вставьте HTML-код счетчика в блог.

if (!ereg("^(.*)\\.(gif|jpg|jpeg|png)$", $item, $p)) continue;

*** Здесь $p- это массив найденных совпадений
*** continue – значит перейти к следующей итерации цикла
2. Замена расширения .ad или .tmx на расширение .txt

$item="._AAABBBCC.3ER_453.34.df.ad"
echo ereg_replace (".ad|.tmx", ".txt", $item);

Получаем

._AAABBBCC.3ER_453.34.df.txt

3. “Стираем” символы ._ или _

$temp=ereg_replace ("(\._|_)", "", $temp);

Получаем

AAABBBCC.3ER453.34.df.txt

4. “Стираем” все символы между (. цифра или цифры)  и любым количеством цифр

$pattern = "((\.[0-9]+).+[0-9]+)";
$replacement ="";
$temp=preg_replace($pattern, $replacement, $temp);

Получаем

AAABBBCC.txt

5. Переставляем местами

$string = "May 10, 2009";
$pattern = "/(\w+) (\d+), (\d+)/i";
preg_replace($pattern, $replacement, $string);

*** Здесь (\w+) обозначает любое количество (но не ноль) букв англ. алфавита, а (\d+) – любое количество цифр.
Для $replacement = "\$3, \$2, \$1"; получаем:

2009, 10, May

Для $replacement = "\${1} 1,\$3"; (вместо $2жестко заданное значение 1) получаем:

May 1,2009

***

Голосование (опрос) – плагин WP-Polls 2.50

Код для добавления на веб-страницу (для опроса номер 1):

[poll id="1"]

Загрузка плагина: wp-polls.2.50.zip

Скриншоты:

Форма голосования

Результаты голосования

<?php if(function_exists('the_views')) { the_views(); } ?></div>

.view {
	float:  left;
	text-align: left;
	padding: 0px 0px 0px 25px;
	background: url(images/view.png) 10px 0px no-repeat;
}

***

Голосование – рейтинг – плагин WP-PostRatings

Рейтинг – это голосование “звездочками” и т.п.. Код для добавления в php-файл, т.е. в index.php или single.php (если этот код добавлен внутри цикла WordPress, рейтинг появляется для каждой записи блога):

<?php if(function_exists('the_ratings')) { the_ratings(); } ?>

Иначе можно добавлять рейтинг на отдельные страницы:

[ratings]

или для записи номер 1:

[ratings id="1"]

Загрузка плагина: wp-postratings.1.40.zip

Скриншоты:

Пример рейтинга записи

Пример рейтинга

Я хочу написать плагин, который добавляет в определенное место на странице случайно выбранную фразу и/или изображение.
В программировании, особенно новичку, часто полезно изучить готовый код, написанный опытным разработчиком, да и не очень-то рационально было бы каждый раз “изобретать велосипед”. Для начала рассмотрим, как работает очень простой плагин “Hello_Dolly”, поставляемый в составе WordPress в качестве примера плагина. (Этот плагин добавляет случайно выбранную фразу на страницу администрирования WordPress.)

Во-первых,

интересно, зачем в начале файла плагина перед

 /*
 Plugin Name: ...
 Plugin URI: ...
 Description: ...
 Author: ...
 Version: ...
 Author URI: ...
 */

добавлено

/**
* @package Hello_Dolly
* @author Matt Mullenweg
* @version 1.5.1
*/

Это теги PHPDoc, генератора документации для php-кода. (Они используются, при генерации документации плагина, и их добавлять в код плагина, конечно же, необязательно.)
PHPDoc-комментарий начинается с /**. Каждая следующая строка должна начинаться с *. Закрывает PHPDoc-комментарий */.

Кстати, по поводу использования тегов встроенной документации в Кодексе WordPress (Inline Documentation) написано:

Для PHPdoc-блоков добавляется информация @since (когда был добавлен) (даже если эта информация пока недоступна), а в качестве информации @package всегда следует указывать “WordPress”, если это не внешняя библиотека:

/**
 * ... Описание
 *
 * @package WordPress
 * @since 2.1 или {{@internal Unknown}}}
 *
 * ... Другая информация
 */

Блоки PHPdoc-комментариев не используются внутри блоков функций и методов за исключением @todo (что нужно сделать).

/**
 * @todo ... Описание
 */

или

/** @todo ... Описание*/

В общем, это интересная тема, но для другой статьи…

Во-вторых,

в плагине используются функции

wptexturize(...)
mt_rand(...) - функция PHP
add_action('admin_footer', 'hello_dolly');
add_action('admin_head', 'dolly_css');
get_bloginfo( 'text_direction' );

и в function dolly_css() задается стиль:

echo "
<style type='text/css'>
#dolly {
position: absolute;
top: 4.5em;
margin: 0;
padding: 0;
$x: 215px;
font-size: 11px;
}
</style>
";
}

С точки зрения создания плагина нас интересует функция WordPress add_action(). После изучения кода плагина понятно, что эта функция добавляет “в заданное место”, точнее в заданный момент (момент загрузки 'admin_footer' и 'admin_head') результат заданной функции ('hello_dolly' и 'dolly_css').

Когда (куда) еще можно добавлять свой php-код?

Плагин может добавлять php-код с помощью хуков, в данном случае используется хук-действие (action hook).
Вот некоторые другие хуки-действия :

• init – WordPress загрузился, но заголовки еще не отправлены
• loop_start – перед обработкой первого поста цикла WordPress
• loop_end – после обработки последнего поста цикла WordPress
• get_footer – перед загрузкой файла шаблона footer.php
• wp_footer – в конце тега <body>. Можно использовать для добавления контента.

Еще хуки

List of all WordPress hooks (Список всех хуков WordPress )
В Кодексе:
Plugin API/Hooks 2.0.x (Хуки-действия)
Plugin API/Filter Reference (Хуки-фильтры)

Добавление случайно выбранной фразы на страницу блога

<?php
/*
Plugin Name: Random Items
Plugin URI: http://mblogm.ru/
Description: Adds a ramdom phrase on every page
Author: MBlogM
Version: 1
Author URI: http://mblogm.ru/
*/
function get_phrase() {
/** Список фраз */
$phrases = "В Интернете кто-то неправ!
Блин! Я целый день работаю. С ума сойти.
Понедельник - день тяжёлый!
Понедельник. Начнем новую жизнь!
Сидим, как в деревне! Ни радио, ни телевизора - один Интернет остался!
Решил собраться с мыслями...ни одна мысль на собрание не пришла...
Может показаться, что я ничего не делаю, но на клеточном уровне я очень занят.
";

// Выделение отдельных строк
$phrases = explode("\n", $phrases);

// Выбор случайной фразы
return wptexturize( $phrases[ mt_rand(0, count($phrases) - 1) ] );
}

// Добавление фразы на страницу
function add_phrase() {

$chosen = get_phrase();
echo "<p id='myphrase'>$chosen</p>";
}

// Привязка функции к действию wp_footer
add_action('wp_footer', 'add_phrase');

?>

Если все оставить так, как есть, фраза появляется в самом низу страницы, поэтому добавим позиционирование:

// Задание положения на странице
function phrase_css() {
echo "
<style type='text/css'>
#myphrase {
position: absolute;
top: 7.5em;
margin: 10;
padding: 10;
right: 70px;
font-size: 12px;
font-color: white;
}
</style>
";
}

add_action('wp_head', 'phrase_css');

Теперь случайно выбранная фраза находится справа в шапке страницы.
Конечно, такой плагин мало интересен. Фразы желательно хранить в базе данных или, хотя бы, в отдельном файле, чтобы можно было добавлять новые фразы, не открывая код плагина.
В общем, следующие шаги – это
(1) запись и извлечение фраз из базы данных и
(2) написание формы для добавления фраз и изменения опций плагина на панели администрирования.

Не могу создать директорию /home/…/public_html/…/wp-content/uploads/… Проверьте, доступна ли родительская директория для записи (Права доступа должны быть 755, 775 либо 777 в зависимости от настроек вашего сервера).

Это значит, что у вас не выставлены права доступа на запись в папку для загрузки файлов или задан неверный путь к этой папке

Права доступа

Для того чтобы изменить права доступа к папке uploads, можно, например, зайти на CPanel в Диспетчер файлов и выбрать команду Изменить разрешения или в Total Commander в меню Файлы команду Изменить артибуты.

Путь к папке

После переноса блога WordPress на новое место в нем может сохраняться старый путь к папке uploads. В этом случае из сообщения об ошибке понятно, что WordPress пытается создать директорию не там, где нужно. Для того чтобы задать правильный путь, зайдите в админке в Настройки, Разное.

Интересно, что в админке WordPress (подсказал Igor@Netovich) нет ссылки на страницу со всеми опциями, на которой также можно все изменять, в том числе и upload_path. Это страница вида

http://mysite.ru/wp-admin/options.php

Если в этих настройках у вас все правильно, обращайтесь  к администратору хостинга.

Прежде чем создавать плагин стоит проверить, может быть подобный плагин уже существует. Если необходимая функциональность еще не реализована в доступных плагинах, можно создать новый плагин.

1. Выбор имени плагина
Имя плагина должно быть уникальным, поэтому следует попробовать найти плагин с выбранным именем на сайте WordPress и в Интернет (например, в поисковой системе google).
WordPress ищет плагины в папке /wp-content/plugins, поэтому для того, чтобы установить плагин, его нужно поместить в эту папку. Потом его можно будет активировать на панели администрирования.

2. Создание папки плагина и его php-файла с выбранным (уникальным) именем: myref и myref.php. (Если плагин будет состоять из одного php-файла, для него можно не создавать отдельную папку)
В начале php-файла плагина должно находиться его описание и лицензия:

<?php
/*
Plugin Name: myref
Plugin URI: http://mblogm.ru
Description: Inserts site's url
Version: 1.0.0
Author: fmblogm
Author URI: http://mblogm.ru

Copyright 2009  fmblogm (email : fmblogm {at} gmail.com)

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
*/
?>

Формально этого уже достаточно для создания плагина. Хотя этот плагин ничего не делает, он появится в списке плагинов, и его можно активировать.

Плагин может просто содержать функции, которые нужно вызывать в шаблоне, а также может реагировать на заданные события (при загрузке плагин сообщает WordPress, на какие события он будет реагировать, и как их обрабатывать.). Более сложные плагины управляются через панель администрирования.

Хуки (hooks)

Хуки обеспечивают привязку плагина к WordPress.

• Действия (Actions) – это хуки, которые WordPress запускает в определенные моменты исполнения или при наступлении определенных событий. В эти моменты в плагине можно задать вызов некоторых PHP-функций с использованием Action API.
• Фильтры (Filters) - это хуки, которые WordPress запускает для того, чтобы изменять значения разных типов перед добавлением их в базу данных или перед отображением в браузере. В эти моменты в плагине можно задать вызов некоторых PHP-функций с использованием Filter API.
• Сокращенный код (Shortcodes) - это хуки, позволяющие добавлять в записи WordPress результат выполнения PHP-функций с использованием Shortcode API (начиная с WordPress 2.5) .

Сокращенный код (Shortcodes)

Поддерживаются шоткоды вида

[shortcode_name attr_1="value_1" ... attr_n="value_n"]

и

[shortcode_name attr_1="value_1" ... attr_n="value_n"]content[/shortcode_name]

Функция-обработчик сокращенного кода может принимать следующие параметры

• $atts – массив атрибутов
• $content – содержимое (когда используется форма с закрывающим тегом)
• $code - имя шоткода (когда оно соответствует имени обратного вызова )

function my_shortcode_handler($atts, $content=null, $code="") {
   // $atts    ::= array of attributes
   // $content ::= text within enclosing form of shortcode element
   // $code    ::= the shortcode found, when == callback name
   // examples: [my-shortcode]
   //           [my-shortcode/]
   //           [my-shortcode foo='bar']
   //           [my-shortcode foo='bar'/]
   //           [my-shortcode]content[/my-shortcode]
   //           [my-shortcode foo='bar']content[/my-shortcode]
}

Регистрация обработчика:

add_shortcode('my-shortcode', 'my_shortcode_handler');

Например, сокращенный код [ref] с поддержкой двух атрибутов text и url. Оба атрибута являются необязательными, и когда они не заданы, применяются их дефолтные значения:

// [ref text="Текст ссылки" url="url ссылки"]
function ref_func($atts) {
extract(shortcode_atts(array(
'text' => 'Study English Now',
'url' => 'http://studyenglishnow.ru/'
), $atts));
return '<noindex><a href="'. $url .'" rel="nofollow">'.$text.'</a></noindex>';
}
add_shortcode('ref', 'ref_func');

Когда вызывается тег шаблона the_content (и отображается содержимое записи), shortcode API анализирует зарегистрированные шоткоды, выделяет их атрибуты и содержимое и передает их обработчику данного шоткода. В тело записи вместо тега (тегов) шоткода добавляется строка, возвращаемая обработчиком.

Еще один пример

Следующий плагин [enti] с атрибутом text вставляет HTML-сущности заданных символов (по умолчанию плагин вставляет “]”; он используется вместо простой квадратной скобки, чтобы показывать на странице текст вызова плагина, например, “[ref]“, а не результат работы этого плагина):

function enti_func($atts) {
extract(shortcode_atts(array(
'text' => ']'
), $atts));
return htmlentities($text);
}
add_shortcode('enti', 'enti_func');

Этот плагин просто позволяет использовать в записи php-функцию htmlentities().
Шоткод [enti text="&"] выведет &amp; (&).

Cron - это демон (программа, которая постоянно работает в системе в фоновом режиме), представляющий собой планировщик задач в UNIX-подобных операционных системах (включая сервер Apache), который в определенное время автоматически выполняет задания. Пример задания – копирование базы данных MySQL в определенное место на сайте (создание резервной копии).

Каждый пользователь системы может добавлять свои задания, указывая, в какое время и какие скрипты нужно выполнять от его имени. Задания могут выполняться, например, раз в день, раз в месяц, раз в год.. На вашем хостинге могут действовать ограничения на общее количество заданий и на то, как часто может выполняться задание (Например, не чаще 1 раза в 10 минут и не более 10 cron-заданий).

Задание (таблица crontab) включает 6 разделов, разделяемых пробелами или табуляцией.

минуты   часы   день_месяца   месяц   день_недели   команда

Первые пять разделов задают время выполнения скрипта:
минуты: 0-59
часы: 0-23
день месяца: 1-31
месяц: 1-12
день недели: 0-7 (0 и 7 – воскресенье)
* – диапазон с первого до последнего.

команда задает скрипт, который нужно выполнять, например, скрипт на Perl или на php. Если команда передает текст в стандартный вывод, этот текст отправляется на e-mail пользователя, но стандартный вывод можно перенаправить в /dev/null:

команда >/dev/null 2>&1

Примеры задания времени выполнения скрипта:
0 22 * * * – каждый день в 22:00
0 0 1 * * – раз в месяц
0,30 10-22 * * * - каждые полчаса между 10:00 и 22:00
0/10 * * * * - каждые 10 минут

Права доступа

На скрипт рекомендуется выставить права доступа 755 (права на исполнение).

Добавление задания Cron в cPanel

В cPanel добавить задание довольно просто. Войдите в “Дополнительно”, “Задания Cron” и заполните форму добавления задания. Но имейте в виду, что выполнение php-скрипта имеет свои особенности.

Выполнение php-скрипта в задании Cron

В выполняемом php-скрипте не должны использоваться переменные окружения. Например, адреса следует прописывать явно. Дело в том, что при выполнении cron-задания в php-скрипте недоступны серверные переменные (например, $_SERVER, $_GET), т.к. веб-сервер Apache не участвует в работе демона cron и не заполняет переменные окружения.

В команде необходимо указать путь к php (может отличаться для разных хостингов), например, /usr/bin/php, затем пробел и полный путь к файлу скрипта:

/usr/bin/php /home/логин/public_html/myscript.php

Пример Cron-задания для выполнения php-скрипта один раз в день (0 0 * * * – задает периодичность)

0 0 * * * /usr/bin/php /home/логин/public_html/myscript.php

Задает обтекание
Не наследуется
Применяется ко всем элементам кроме позиционированных

Может принимать значения

left - Выравнивает элемент по левому краю, последующие элементы огибают его справа.
right - Выравнивает элемент по правому краю, последующие элементы огибают его слева.
none - Обтекание элемента не задано.

clear

Отменяет обтекание
Не наследуется
Применяется к блочным и плавающим элементам
Если установлено обтекание с помощью float, отменяет его действие.

Может принимать значения

both - Отменяет обтекание элемента одновременно с правого и левого края.
left - Отменяет обтекание с левого края. Последующие элементы будут располагаться под текущим элементом.
right - Отменяет обтекание с правой стороны.
none (применяется по умолчанию) – Отменяет действие clear, и обтекание выполняется так, как задано с помощью float или других настроек.

Если в посте WordPress используются теги <div>, для того чтобы остальные элементы страницы “не перекосило”, в конце поста может потребоваться отменить применяемое обтекание, например, добавив пустой тег (без содержимого)

<div style="clear:both"></div>

или

<div class="lastcol"></div>

а класс “lastcol” определяется в файле style.css так:

div.lastcol{clear: both}