Как мне вызвать функции из моего плагина в шаблоне WP? - PullRequest
Новая
       11

Как мне вызвать функции из моего плагина в шаблоне WP?

5 голосов
/ 23 сентября 2010

Я создал плагин календаря, и теперь я хочу показать список событий в одном из моих шаблонов.Код, который я сейчас использую, таков: 

include_once(WP_CAL_PLUGIN_DIR.'eventcal.class.php');

$calendar = new EventCalendar();
$events = $calendar->getMultipleEvents('5');

(...)

<table>
<?php foreach($events as $event) : ?>
  <tr>
    <td><span><?php echo $calendar->formatEventTime($event->startTime,'dm'); ?></span></td>
    <td><span><?php echo $calendar->formatEventTime($event->startTime,'time'); ?></span></td>
    <td><?php echo $event->name; ?></td>
  </tr>
<?php endforeach; ?>
</table>

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

Ответы [ 2 ]

8 голосов
/ 25 сентября 2010

Чтобы выполнить шорткод внутри шаблона, используйте функцию do_shortcode('[my-shortcode-handle]'). Ваш шорткод должен быть зарегистрирован как обычно ( см. WordPress codex по шорткоду API ), прежде чем использовать его в шаблоне. Любые атрибуты, внутренний контент и т. Д. Также должны быть там. 

echo do_shortcode( '[my-shortcode foo="bar"]Shortcode content[/my-shortcode]' );

Кроме того, не забудьте повторить возврат (или, по крайней мере, присвоить его переменной), поскольку он возвращает только вывод шорткода.

2 голосов
/ 24 сентября 2010

From: http://codex.wordpress.org/Plugin_API

WordPress предоставляет хуки, чтобы ваш плагин мог "подключиться" к остальной части WordPress;то есть вызывать функции в вашем плагине в определенное время и тем самым приводить ваш плагин в движение.Существует два вида хуков:

  1. Действия: Действия - это хуки, которые ядро ​​WordPress запускает в определенных точках во время выполнения или при возникновении определенных событий.Ваш плагин может указать, что одна или несколько его функций PHP выполняются в этих точках с использованием API действий.

  2. Фильтры: Фильтры - это ловушки, которые WordPress запускает для изменения текста различных типов перед его добавлением.в базу данных или отправив его на экран браузера.Ваш плагин может указать, что одна или несколько его функций PHP выполняются для изменения определенных типов текста в это время, используя API-интерфейс фильтра.

    Действия

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

* Modify database data
* Send an email message
* Modify what is displayed in the browser screen (admin or end-user)

Основные шаги, чтобы это произошло (более подробно описано ниже):

  1. Создайте функцию PHP, которая должна выполняться при возникновении события, в файле плагина.
  2. Подключитесь к действию в WordPress, вызвав add_action ()
  3. ПоместитеФункция PHP в файле плагина, и активировать его.

ПРИМЕР: 

function email_friends($post_ID)  {
    $friends = 'bob@example.org,susie@example.org';
    mail($friends, "sally's blog updated", 
      'I just put something on my blog: http://blog.example.com');
    return $post_ID;
}

Соединение с WordPress

После того, как ваша функция определена, следующим шагом будет "зацепить" илизарегистрируйте его в WordPress.Для этого вызовите add_action () в глобальном пространстве выполнения вашего файла плагина: 

add_action ( 'hook_name', 'your_function_name', [priority], [accepted_args] );

где:

hook_name Имя обработчика действий, предоставляемого WordPress, который сообщает, какое событиеВаша функция должна быть связана с.your_function_name Имя функции, которую вы хотите выполнить после события, указанного в hook_name.Это может быть стандартная функция php, функция, присутствующая в ядре WordPress, или функция, определенная вами в файле плагина (например, «email_friends», определенная выше).priority Необязательный целочисленный аргумент, который можно использовать для указания порядка, в котором выполняются функции, связанные с конкретным действием (по умолчанию: 10).Меньшие числа соответствуют более раннему выполнению, а функции с одинаковым приоритетом выполняются в том порядке, в котором они были добавлены к действию.accept_args Необязательный целочисленный аргумент, определяющий, сколько аргументов может принять ваша функция (по умолчанию 1), полезно, потому что некоторые хуки могут передавать в функцию более одного аргумента.Этот параметр является новым в версии 1.5.1.

В приведенном выше примере мы добавили бы следующую строку в файл плагина: 

add_action ( 'publish_post', 'email_friends' );
...