WordPress => Разработка плагинов

Синтаксис

add_action (string $ tag, вызываемый $ function_to_add, int $ priority = 10, int $ accepted_args = 1)
add_filter (string $ tag, вызываемый $ function_to_add, int $ priority = 10, int $ accepted_args = 1)

параметры

параметр	подробность
$ тег	(строка) (обязательно) Имя фильтра для привязки обратного вызова $ function_to_add.
$ function_to_add	(вызываемый) (обязательно) Обратный вызов должен выполняться при применении фильтра.
$ приоритет	(int) (Необязательно) Используется для указания порядка, в котором выполняются функции, связанные с конкретным действием. Более низкие номера соответствуют более раннему исполнению, а функции с одинаковым приоритетом выполняются в том порядке, в котором они были добавлены к действию. Значение по умолчанию: 10
$ accepted_args	(int) (Необязательно) Число аргументов, которые функция принимает. Значение по умолчанию: 1

замечания

Способ работы Plugin hooks заключается в том, что в разное время, пока работает WordPress, WordPress проверяет, не запустили ли какие-либо плагины функции, которые будут выполняться в это время, и если это так, функции выполняются. Эти функции изменяют поведение WordPress по умолчанию.

Существует два вида крючков:

Фильтры дают вам возможность изменять значение части данных во время выполнения WordPress. Функции обратного вызова для фильтров будут передаваться через переменную, изменяться, а затем возвращаться. Они предназначены для работы изолированным образом и никогда не должны влиять на глобальные переменные или что-либо еще вне функции.

Действия , напротив, позволяют вам добавлять или изменять способ работы WordPress. Функция обратного вызова будет выполняться в определенный момент выполнения WordPress и может выполнять какую-то задачу, например, повторять вывод пользователю или вставлять что-то в базу данных.

Ссылка фильтра

Ссылка на действие

руководство

API-интерфейс плагина

Фильтры против действий

Фильтр

add_filter('comment_text','before_comment');
add_filter('comment_text','after_comment');
function before_comment($comment_text){
            return 'input before comment'.$comment_text;
        }
function after_comment($comment_text){
            return $comment_text.'input after comment';
        }

действие

add_action('wp_head','hook_javascript');

function hook_javascript() {
    $output="<script> alert('Page is loading...'); </script>";
    echo $output;
}

Примеры разработки плагинов: любимый виджет песни

    <?php
function wpshout_register_widgets() {
    register_widget( 'Favorite_Song_Widget');
}

add_action( 'widgets_init', 'wpshout_register_widgets' );

class Favorite_Song_Widget extends WP_Widget {

function Favorite_Song_Widget() {
    // Instantiate the parent object
    parent::__construct(
            'favorite_song_widget', // Base ID
            __('Favorite Song', 'text_domain'), // Name
            array( 'description' => __( 'Widget for playable favorite song', 'text_domain' ), ) // Args
    );
}

function widget( $args, $instance ) {
    echo $args['before_widget']; 
    echo '<h3>Favorite Song Lists:</h3>';
    echo $instance['songinfo'];
    echo '<a href="' . $instance['link'] . '">Download it</a><br>';
    echo $instance['description'];
            echo $args['after_widget'];
}

function update($new_abc,$old_abc) {
    $instance = $old_abc;
    // Fields
    $instance['link'] = strip_tags($new_abc['link']);
    $instance['songinfo'] = strip_tags($new_abc['songinfo']);
            $instance['description'] = strip_tags($new_abc['description']);
    return $instance;
}

// Widget form creation
function form($instance) {
     $link = '';
    $songinfo = '';
            $description = '';
    // Check values
    if( $instance) {
        $link = esc_attr($instance['link']);
        $songinfo = esc_textarea($instance['songinfo']);
                    $description = esc_textarea($instance['description']);
    } ?>
     

    <p>
        <label for="<?php echo $this->get_field_id('link'); ?>"><?php _e('Link', 'wp_widget_plugin'); ?></label>
        <input class="widefat" id="<?php echo $this->get_field_id('link'); ?>" name="<?php echo $this->get_field_name('link'); ?>" type="text" value="<?php echo $link; ?>" />
    </p>
     
    <p>
        <label for="<?php echo $this->get_field_id('songinfo'); ?>"><?php _e('Song Info:', 'wp_widget_plugin'); ?></label>
        <input class="widefat" id="<?php echo $this->get_field_id('songinfo'); ?>" name="<?php echo $this->get_field_name('songinfo'); ?>" type="text" value="<?php echo $songinfo; ?>" />
    </p>
            
            <p>
        <label for="<?php echo $this->get_field_id('description'); ?>"><?php _e('Description:', 'wp_widget_plugin'); ?></label>
        <textarea class="widefat" id="<?php echo $this->get_field_id('description'); ?>" name="<?php echo $this->get_field_name('description'); ?>" type="text" value="<?php echo $description; ?>"></textarea>
    </p>
            
            <p><a href="#" id="add-more-tabs"><?php _e('Add More Tabs', 'wp_widget_plugin'); ?></a></p>
    
<?php }

}

Modified text is an extract of the original Stack Overflow Documentation

Лицензировано согласно CC BY-SA 3.0

Не связан с Stack Overflow

WordPress
Разработка плагинов

Поиск…