Слайды с моей презентации на WordCamp Russia 2015 о фильтрах и событиях в WordPress.

1. События и фильтры
в WordPress
WordCamp Russia 201515 августа

2. Игорь Зиновьев
Automattic
jetpack.me
@zinigor

3. WordPress – платформа
Легкость создания своего функционала.
За счет чего она достигается?
Что такое «хуки»?

4. События и фильтры
Есть ли отличия, и в чём они?

5. function add_action( . . . ) {
return add_filter( . . . );
}
https://core.trac.wordpress.org/browser/tags/4.2.2/src/wp-includes/plugin.php#L429
События и фильтры
это практически одно и то же

6. Почему именно события?
Какие преимущества даёт использование обработчиков событий
при разработке программного обспечения?

7. Зачем так сложно?
Если я скачал WordPress, я могу делать с ним что хочу, правда?
Почему бы не внести правки в чужой код напрямую?

8. Как использовать «хуки»?
add_action( 'init', 'lol_action_handler' );
function lol_action_handler() {
wp_die( 'LOL' );
}

9. Как использовать «хуки»?
add_filter( 'the_title', 'lol_title_filter' );
function lol_title_filter( $title ) {
return $title . ' LOL';
}

10. Как быть, если хук уже используется?
add_action(
'init',
'lol_action_handler',
10 // приоритет - чем меньше, тем раньше,
// если одинаковый приоритет - FIFO
);

11. Что если нужно принять параметры?
add_filter(
'the_title',
'lol_title_filter',
10,
1 // количество параметров на входе
// функции-обработчика
);

12. Как быть, если я люблю ООП?
add_filter(
'the_title',
array( $object, 'lol_filter_method' )
// метод объекта
);

13. Как быть, если я люблю ООП?
add_filter(
'the_title',
array( 'Lmao_Rofl', 'lol_filter_method' )
// статический метод класса
);

14. Как быть, если я люблю PHP 5.3?
add_filter(
'the_title',
array( 'LolSpacelol_filter_method' )
// функция внутри пространства имён
);

15. Как быть, если я люблю PHP 5.3?
add_filter(
'the_title',
function() {
// анонимная функция
}
);

16. А как отменить?
remove_action(
'init',
'lol_action_handler',
10
);

17. А если нужно вернуть простое
значение?
__return_true()
__return_false()
__return_zero()
__return_null()
__return_empty_string()
__return_empty_array()

18. Какие бывают события?
https://codex.wordpress.org/Plugin_API/Action_Reference
загрузились плагины
пользователь авторизовался
начало подключения JS
загрузился постзагрузилось меню администратора
новый медиафайл
новый комментарий
выбор шаблона
активация плагина
сброс пароля

19. Какие бывают события?
https://codex.wordpress.org/Plugin_API/Action_Reference
загрузились плагины
пользователь авторизовался
начало подключения JS
загрузился постзагрузилось меню администратора
новый медиафайл
новый комментарий
выбор шаблона
активация плагина
сброс пароля
template_redirect

20. Какие бывают события?
https://codex.wordpress.org/Plugin_API/Action_Reference
загрузились плагины
пользователь авторизовался
начало подключения JS
загрузился постзагрузилось меню администратора
новый медиафайл
новый комментарий
выбор шаблона
активация плагина
сброс пароля
comment_post

21. Какие бывают события?
https://codex.wordpress.org/Plugin_API/Action_Reference
загрузились плагины
пользователь авторизовался
начало подключения JS
загрузился постзагрузилось меню администратора
новый медиафайл
новый комментарий
выбор шаблона
активация плагина
сброс пароля
all

22. Как дать возможность другим
использовать «хуки»?
А также зачем это нужно?

23. Моя тема или плагин
взаимодействуют с другими.
do_action( 'lmao_rofl_init', $data, … );
$new_data = apply_filter(
'lmao_rofl_data',
$data,
$argument,
…
);

24. Документируйте события и
фильтры.
• Легкая настройка
• Взаимодействие
• Сотрудничество при разработке

25. Например, фильтры в Jetpack.
jetpack_photon_skip_image
https://github.com/Automattic/jetpack/blob/master/class.photon.php#L155
jetpack_widget_name
https://github.com/Automattic/jetpack/blob/master/class.jetpack-client.php#L261
jetpack_can_make_outbound_https
https://github.com/Automattic/jetpack/blob/master/modules/widgets/facebook-likebox.php#L33

26. Например, фильтры в Jetpack.
jetpack_photon_skip_image
https://github.com/Automattic/jetpack/blob/master/class.photon.php#L155
jetpack_widget_name
https://github.com/Automattic/jetpack/blob/master/class.jetpack-client.php#L261
jetpack_can_make_outbound_https
https://github.com/Automattic/jetpack/blob/master/modules/widgets/facebook-likebox.php#L33

27. Например, фильтры в Jetpack.
jetpack_photon_skip_image
https://github.com/Automattic/jetpack/blob/master/class.photon.php#L155
jetpack_widget_name
https://github.com/Automattic/jetpack/blob/master/class.jetpack-client.php#L261
jetpack_can_make_outbound_https
https://github.com/Automattic/jetpack/blob/master/modules/widgets/facebook-likebox.php#L33

28. Фильтр очень просто добавить.
Участвуйте в разработке своих любимых тем и плагинов.

29. Спасибо за внимание!
Буду рад ответить на ваши вопросы!