WordPress как на ладони
Шаблоны, плагины и темы для настоящих поклонников Elementor. От TemplateMonster.com wordpress jino

Заголовки плагина

Заголовки плагина - это важный компонент, который сообщает WordPress, что PHP файл внутри каталога плагинов является плагином WordPress. Такие заголовки выглядят как PHP комментарий в начале файла, который должен соответствовать определенным стандартам, ниже о них.

Создание заголовков

Заголовок плагина должен находится в основном файле плагина и только там.

Как минимум, заголовок должен содержать имя плагина:

<?php
/**
 * Plugin Name: Мой первый плагин
 */

// код плагина

В заголовке могут быть указанны и другие данные:

<?php
/**
 * Plugin Name: Название плагина
 * Description: Описание плагина желательно не очень длинное (140 символов)
 * Plugin URI:  Ссылка на инфо о плагине
 * Author URI:  Ссылка на автора
 * Author:      Имя автора
 * Version:     Версия плагина, например 1.0
 *
 * Text Domain: Идентификатор перевода, указывается в load_plugin_textdomain()
 * Domain Path: Путь до файла перевода. Нужен если файл перевода находится не в той же папке, в которой находится текущий файл.
 *              Например, .mo файл находится в папке myplugin/languages, а файл плагина в myplugin/myplugin.php, тогда тут указываем "/languages"
 *
 * License:     GPL2
 * License URI: https://www.gnu.org/licenses/gpl-2.0.html
 *
 * Network:     Укажите "true" для возможности активировать плагин по все сети сайтов (для Мультисайтовой сборки).
 */

// код плагина

Рассмотрим все возможные параметры заголовка:

Plugin Name:(обязательный)
Название плагина, которое отображается в списке плагинов в админке.
Description:
Краткое описание плагина, которое отображается в разделе Плагины в в админке. Рекомендуется не превышать 140 символов.
Version:

Номер текущей версии плагина, например, 1.0 или 1.0.3.

При установке версии имейте ввиду, что WP для сравнения версий использует функцию version_compare(). Поэтому при изменении версии убедитесь что новая версия будет выше. Например, 1.02 больше чем 1.1

Plugin URI:
Домашняя страница плагина, которая может быть на WordPress.org или на вашем собственном сайте.
Author:
Имя автора плагина.  В списке может быть более одного автора.
Author URI:
Сайт автора или профиль на другом веб-сайте, например, WordPress.org.
License:
Короткое имя лицензии плагина, например GPL2. Более подробную информацию о лицензировании можно найти на WordPress.org.
License URI:
Ссылка на лицензию, например, https://www.gnu.org/licenses/gpl-2.0.html .
Text Domain:
ID перевода (домен локализации) используется в функциях локализации и в названии файла перевод mo.
Domain Path:
Используется чтобы WordPress знал, где находятся файлы перевода. Например /lang означает что в папке плагина есть папка lang и в ней лежать .mo файл перевода.
Network:
Укажите "true" чтобы плагин обязательно активировался по всей сети сайтов в MU сборке WordPress. Это сделает невозможным активировать плагин для одного сайта, если активирована мультисеть.

Размер заголовка

Заголовок плагина разбирается функцией get_plugin_data(), которая обрабатывает только первые 8kiB (6000-8000 символов) информации, и если данные плагина получаются больше, то автору придется их уменьшить или переместить данные плагина наверх. Такое может произойти, если например, добавить данные о лицензии перед данными плаглина.

Указание лицензии плагина

Большинство плагинов WordPress опубликованы под лицензией GPL, что соответствует той же лицензии, которую использует сам WordPress. Тем не менее, есть и другие варианты. Лучше всегда четко указать, какую лицензию использует ваш плагин.

Выше было показано, что лицензию можно указать в параметр заголовка License:. Но есть еще одна распространенная практика - поместить блок лицензии под заголовками плагина в основном файле плагина.

Блок лицензии выглядит примерно так:

{Plugin Name} 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
any later version.

{Plugin Name} 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 {Plugin Name}. If not, see {URI to Plugin License}.

Объединив с заголовками плагина получим:

/*
Plugin Name: Plugin Name
Plugin URI: http://URI_Of_Page_Describing_Plugin_and_Updates
Description: This describes my plugin in a short sentence
Version: 1.5
Author: John Smith
Author URI: http://URI_Of_The_Plugin_Author
License: GPL2

{Plugin Name} 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
any later version.

{Plugin Name} 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 {Plugin Name}. If not, see {License URI}.
*/
6 комментов
  • Николай cайт: vk.com/nikolays_93

    Как установить мультиязычное название плагина?

    • Kama6811

      Указываешь Text Domain: и Domain Path:.

      Потом в коде указываешь строку для перевода, чтобы она попала в файл перевода. Например так:

      /**
       * Plugin Name: Название плагина
       * Description: Описание плагина желательно не очень длинное (140 символов)
       * Text Domain: domain
       * Domain Path: /languages/
       */
      
      // код плагина
      __('Название плагина');
      __('Описание плагина желательно не очень длинное (140 символов)');

      Делаешь перевод этих строк в poedit и все! Дальше ВП сам подхватит их по указанным в комментах Text Domain и Domain Path.

      2
      • у Вас на сайте стока много интересного, а для начинающего пожалуйста мона что нибудь интересное - например я ввожу логин и пароль в админке WP

        и эта парочка летит в сеть интернет на хостинг в каком виде ?
        если на сайт захожу по обычному http - на сайте SSL https не подключен

        • то есть не шифрованный канал, и интересно - вводить пароль и логин
          для входа на сайт под админом опасно ?

        логин и пароль в зашифрованном виде летят на сервер

        • в общем очень нужна ваша помощь пожалуйста подскажите по подробнее

        • а то как то не известно что будит если заходить в админку на сайт WP
        • кто то другой потом зайдет по этим же логину и паролю подсмотренному

        в сети интернет есть много хороших людей, могут зайти в админку
        сделать там как нужно - наведут порядок smile

        • @ campusboy2988 cайт: www.youtube.com/c/wpplus

          то есть не шифрованный канал, и интересно - вводить пароль и логин
          для входа на сайт под админом опасно ?

          Сколько десятилетий так делали и как-то выжили, правда? Миллионы сайтов до сих пор так работают. Так что вводи и не парься. Но конечно лучше перевести сайт на https, тем более сейчас чуть ли не каждый хостинг делает в пару кликов и бесплатно.

          1
      • Николай

        Все гениальное просто smile Спасибо!

  • Сергей cайт: экоферма22.рф

    Спасибо за уроки! Вопрос - у Вас есть уроки, как написать плагин под WooCommerce? Я хочу создать плагины витрины - типа этого (но с доработками) http://экоферма22.рф/2017/01/14/bystraya-vitrina-zakaza/ (сайт мой) и статистика продаж(а то дефолтная весьма убогая) и плагин массового редактирования товаров(цена,количество). Изучаю программирование недавно. Заранее спасибо!

    1
Здравствуйте, !     Войти . Зарегистрироваться