Все записи автора Profer

программист

Шорткоды в WordPress

17.02.2014 Profer Оставить комментарий

Порой необходимо вывести в определённое место поста какой-нибудь вставки, например галерею или рекламу. Для этого можно использовать шорткоды, добавив прямо в текст статьи вставку подобного вида:

[shortcode param1="123" param2="abc"]

1	[shortcode param1="123" param2="abc"]

Таким образом мы можем вызвать заранее определённую функцию, которая будет прикреплена к названию шорткода. Название может быть любое, в данном случае было выбрано "shortcode". Так же в данном случае в функцию будут переданы ещё два параметра: param1 и param2. Однако указывать параметры не обязательно, если ваша функция их не использует.

Теперь нужно написать нашу функцию и привязать её к соответствующему шорткоду.

function shortcode_func( $atributs ) {
	extract( shortcode_atts( array(
		'param1' => 'значение по-умолчанию1',
		'param2' => 'значение по-умолчанию2',
	), $atributs ) );

	return "<img src='$param1' alt='$param2' />";
}
add_shortcode( 'shortcode', 'shortcode_func' );

function shortcode_func( $atributs ) {

extract( shortcode_atts( array(

'param1' => 'значение по-умолчанию1',

'param2' => 'значение по-умолчанию2',

), $atributs ) );

return "<img src='$param1' alt='$param2' />";

}

add_shortcode( 'shortcode', 'shortcode_func' );

С помощью специальной функции add_shortcode мы привязали нашу функцию shortcode_func к выводу шорткода shortcode. В функции сделана распаковка входных данных $atributs в отдельные переменные. Так же для переменных указаны значения по-умолчанию, которые будут использованы, если не указать при добавлении шорткода этих параметров. Если вы не используете параметры при добавлении вообще, то и тогда в самой функции не надо делать распаковку входных параметров.

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

Внутренний функционал

Встроенный сron в WordPress

05.02.2014 Profer Оставить комментарий

Порой бывает необходимо выполнять какие-то действия периодический, например рассылка или какая-нибудь обработка данных. Хорошо если есть доступ к Cron-у на сервер, но если его нет, то можно использовать встроенный в WordPress. Осталось разобраться как собственно прицепится к нему.

Главная функция, которая собственно цепляется за cron, выглядит так:

wp_schedule_event($timestamp, $recurrence, $hook, $args);

1	wp_schedule_event($timestamp, $recurrence, $hook, $args);

Разберёмся с параметрами:

$timestamp - когда запустить cron, необходимо указать время в Unix-формате, если с текущего момента, то просто time()
$recurrence - как часто запускать, по умолчанию доступны 3 варианта:
- hourly - раз в час
- twicedaily - каждые 12 часов
- daily - раз в день
так же можно добавить свои варианты, но об этом позже
$hook - собственно название нашего cron-а, можно придумать любое, оно служит для идентификации для других функций
$args - аргументы, которые будут передаваться нашей запускаемой функции (не обязательный параметр)

Для примера буду использовать активацию плагина, т.к. внутренний cron как раз используется в основном в плагинах.

function funct_cron_hourly(){
	wp_mail( 'me@example.net', 'Запустился, 'Кроновская функция была запущена' );
}

function my_plugin_activation() { 
    if ( ! wp_next_scheduled( 'funct_hourly' ) )
        wp_schedule_event(time(), 'hourly', 'funct_hourly'); 
}

register_activation_hook(__FILE__, 'my_plugin_activation'); 
add_action('funct_hourly', 'funct_cron_hourly');

function funct_cron_hourly(){

wp_mail( 'me@example.net', 'Запустился, 'Кроновская функция была запущена' );

}

function my_plugin_activation() {

if ( ! wp_next_scheduled( 'funct_hourly' ) )

wp_schedule_event(time(), 'hourly', 'funct_hourly');

}

register_activation_hook(__FILE__, 'my_plugin_activation');

add_action('funct_hourly', 'funct_cron_hourly');

В данном примере, после активации плагина, будет запускаться функция funct_hourly (мы повесили её с помощью функции add_action на идентификатор cron-а), которая в свою очередь будет отправлять письмо с уведомлением о запуске. Обратите внимание на функцию wp_next_scheduled, она проверяет был ли запущен подобный cron или нет, иначе при каждой активации вы будете получать новый дубль cron-а. Так что в данном случае, если функцию проверки убрать и активировать плагин 3 раза, вы будете получать по 3 письма каждый час.

С включением крона разобрались, теперь осталось научиться его отключать. Для этого используется следующая функция:

wp_unschedule_event( $timestamp, $hook);

1	wp_unschedule_event( $timestamp, $hook);

Параметры:

$timestamp - время, когда крон будет запущен в следующий раз
$hook - название нашего cron-а

Пример отключения при деактивации плагина:

function binet_cron_deactivation() { 
    $timestamp = wp_next_scheduled( 'funct_hourly' );
    wp_unschedule_event( $timestamp, 'funct_hourly');
}

register_deactivation_hook(__FILE__, 'my_plugin_deactivation');

function binet_cron_deactivation() {

$timestamp = wp_next_scheduled( 'funct_hourly' );

wp_unschedule_event( $timestamp, 'funct_hourly');

}

register_deactivation_hook(__FILE__, 'my_plugin_deactivation');

С помощью функции wp_next_scheduled мы получаем время, когда будет запущен в очередной раз наш cron, а потом передаём в функцию деактивации. Так же можно отключить все запланированные ранее кроны с помощью функции wp_clear_scheduled_hook(). Она основана на функции wp_unschedule_event() и вызывается так:

wp_clear_scheduled_hook( 'funct_hourly' );

1	wp_clear_scheduled_hook( 'funct_hourly' );

Ну и напоследок расскажу как задавать свои интервалы времени:

add_filter( 'cron_schedules', 'cron_add_new' );

function cron_add_new( $schedules ) {
 	$schedules['weekly'] = array(
 		'interval' => 604800,
 		'display' => __( 'Раз в неделю' )
 	);
 	return $schedules;
}

add_filter( 'cron_schedules', 'cron_add_new' );

function cron_add_new( $schedules ) {

$schedules['weekly'] = array(

'interval' => 604800,

'display' => __( 'Раз в неделю' )

);

return $schedules;

}

Мы указали свою функцию cron_add_new, которая передаёт параметры для нового интервала. Здесь всё просто: указываем interval в количестве секунд, а так же display - это просто описание. Таким образом вы можете задать любой удобный для вас интервал.

SEO

Скрытие ссылок и блоков с помощью JS/Ajax

03.02.2014 Profer Оставить комментарий

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

Скрытие блоков

Самый первый и простой способ, который мной был тестирован несколько лет назад - это просто оборачивание блока в JS-вывод. Например:

document.write('<div class="info">Какая-то информация</div>');

1	document.write('<div class="info">Какая-то информация</div>');

Такой способ прост, но в данном случае информация остаётся на странице, хоть и завёрнутая в блок script. Раньше поисковики не учитывали подобные js-блоки, но теперь они вполне способны это переварить, что нас может весьма не устраивать 🙂

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

Основная часть - это вывод самого блока. Рекомендую сделать один скрипт, который будет делать вывод блока, в зависимости от того, какой мы его попросим. Например через $_POST-запрос отправлять переменную с названием блока.

В самом выводе есть два варианта. Первый - когда блок у вас статичен и не меняется. Тут всё просто, забиваем его в в скрипт вывода. Выглядеть будет примерно так:

if(isset($_POST['act'])){
    if($_POST['act']=='block_info'){ ?>
        <div>Какая-то информация</div>
<?php } 
}

if(isset($_POST['act'])){

if($_POST['act']=='block_info'){ ?>

<div>Какая-то информация</div>

<?php }

}

В другом случае - блок динамический (например те же последние новости/записи). В этом случае нам нужно будет подсоединить к нашему скрипту ещё и сам движок WP. Делается это просто, необходимо подсоединить файл wp-config.php, а он за собой уже подтянет весь движок. Блок для вывода последних постов будет так:

if(isset($_POST['act'])){
	if($_POST['act']=='block_info'){ ?> 
		include('../wp-config.php'); 
		<div class="title">Последние статьи</div> 
		<?php $the_query = new WP_Query( array( 'post_type' => 'post', 'posts_per_page' => 5, 'order' => 'DESC' ) );
		while ($the_query->have_posts()) : $the_query->the_post(); ?>
			<a href="<?php the_permalink(); ?>"><?php the_title(); ?></a> 
		<?php endwhile;
		wp_reset_query(); ?> 
<?php } 
}

if(isset($_POST['act'])){

if($_POST['act']=='block_info'){ ?>

include('../wp-config.php');

<div class="title">Последние статьи</div>

<?php $the_query = new WP_Query( array( 'post_type' => 'post', 'posts_per_page' => 5, 'order' => 'DESC' ) );

while ($the_query->have_posts()) : $the_query->the_post(); ?>

<?php endwhile;

wp_reset_query(); ?>

<?php }

}

Но у данного подключения движка есть один минус, если у вас много посетителей и вы используете плагин кеширования, то плагин не будет кешировать эти данные, поэтому придётся придумать своё кеширование, чтобы избежать черезмерной нагрузки.

Теперь необходимо это закинуть куда-нибудь на сайт, например в папку "ajax" в корень сайта, а сам файл назвать output.php.

Теперь приступим к выводу на стороне пользователя. Здесь мы просто должны сделать $_POST-запрос с названием нужного нам блока. Например так:

$.ajax({
	type: "POST",
	url: "/ajax/output.php",
	data: {act:'block_info'},
	dataType : "text",
	success: function(msg){
		$('#block_info').html(msg);
	}
});

$.ajax({

type: "POST",

url: "/ajax/output.php",

data: {act:'block_info'},

dataType : "text",

success: function(msg){

$('#block_info').html(msg);

}

});

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

<div id="block_info"></div>

1	<div id="block_info"></div>

Скрытие ссылок

Тут можно поступить так же, как и с блоками: самый простой - просто обернуть в JS, посложнее - AJAX, но тут для каждой ссылки нужно будет задавать своё название.

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

<div>
	<a href="http://www.example.net/post.html"><img src="http://www.example.net/wp-content/uploads/2014/01/img.png" alt="Миниатюра поста" /></a>
	<div class="post-info"><a href="http://www.example.net/post.html">Заголовок поста</a></div>
</div>

<div>

<div class="post-info"><a href="http://www.example.net/post.html">Заголовок поста</a></div>

</div>

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

<div>
	<img src="http://www.example.net/wp-content/uploads/2014/01/img.png" alt="Миниатюра поста" class="replace donor" />
	<div class="post-info"><a href="http://www.example.net/post.html" class="donor">Заголовок поста</a></div>
</div>

<div>

<div class="post-info"><a href="http://www.example.net/post.html" class="donor">Заголовок поста</a></div>

</div>

Как мы видим, здесь добавились классы, класс "replace" указывает, кто будет принимать ссылку, а по классу "donor" мы будем определять пару для поиска. Поиск и подстановка события onclick через JS выглядит так:

$(document).ready(function(){
	$('.replace').live('click', function() {
		var strClass="a."+$(this).attr('class').replace("replace ", "");
		document.location.assign($(strClass).attr('href'));
	});
});

$(document).ready(function(){

$('.replace').live('click', function() {

var strClass="a."+$(this).attr('class').replace("replace ", "");

document.location.assign($(strClass).attr('href'));

});

В итоге мы получим нормальную ссылку с анкором, а так же изображение, при клике на которое будет происходить переход по этой ссылке.

Есть и четвёртый вариант. В данном случае мы не будем указывать явно ссылку, а зададим её через сторонний атрибут "date-loc" и заменим слеши на пробелы, т.е. было так:

<a href="/category/podcategory">Текст ссылки</a>

1	<a href="/category/podcategory">Текст ссылки</a>

стало:

<div date-loc="category podcategory" class="new_location">Текст ссылки</div>

1	<div date-loc="category podcategory" class="new_location">Текст ссылки</div>

Теперь осталось через JS задать действие для перехода, для всех ссылок, которым мы указали класс "new_location":

$('.new_location').live('click', function() {
	document.location.assign("/" + $(this).attr("date-loc").split(" ").join("/"));
});

$('.new_location').live('click', function() {

document.location.assign("/" + $(this).attr("date-loc").split(" ").join("/"));

});

Таким образом будут обратно подставляться слеши и делаться переход при клике.

Какой вариант лучше, выбирайте сами 🙂 Так же не забывайте, что для исправной работы всех представленных выше кодов, вам понадобится подключённая библиотека JQuery.

Внутренний функционал

Изменение изображений с помощью встроенных средств

31.01.2014 Profer Оставить комментарий

С версии 3.5.0 появился весьма удобный редактор изображений wp_get_image_editor. Сегодня поговорим о его возможностях, а в конце я приведу одну готовую полезную функцию.

Вызов осуществляется следующим образом:

$img = wp_get_image_editor( ABSPATH.'wp-content/uploads/img.jpg' );

1	$img = wp_get_image_editor( ABSPATH.'wp-content/uploads/img.jpg' );

Основной аргумент - это собственно путь до изображения, с которым мы будем работать. После чего можно использовать различные методы для изменения изображения.

Основной функционал следующий:

1) Изменение размера:

$img->resize( 180, 120, true );

1	$img->resize( 180, 120, true );

Первое значение соответственно ширина нового изображения, а второе - высота. Последний аргумент отвечает за то, будет ли использоваться обрезка изображения или нет. В данном случае будет создана миниатюра с разрешением 180х120, которая будет обрезана по большей стороне, если само изображение не соответствует данному соотношению сторон (3:2).

2) Изменение качества сжатия:

$img->set_quality( 100 );

1	$img->set_quality( 100 );

Главный аргумент - значение числа от 1 до 100, чем выше, тем лучше качество, чем ниже тем меньше размер итогового изображения.

3) Вырезка куска изображения:

$img->crop( $start_x, $start_y, $width, $heigh, $new_width, $new_height);

1	$img->crop( $start_x, $start_y, $width, $heigh, $new_width, $new_height);

Параметры $start_x и $start_y отвечают за отступ начальной позиции для вырезки, $width и $height - отвечают за ширину и высоту того куска, который будет вырезан. Последние два аргумента $new_width и $new_height отвечают за новый размер вырезанного куска изображения, можно не указывать.

4) Вращение:

$img->rotate( 270 );

1	$img->rotate( 270 );

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

5) Зеркалирование:

$img->flip( true, false );

1	$img->flip( true, false );

Здесь всего два аргумента, первый - будет ли повёрнуто изображение относительно горизонтали, а второе - будет ли повёрнуто изображение относительно вертикали.

6) Сохранение:

$save_img = $img->save(ABSPATH.'wp-content/uploads/new_file.jpg');

1	$save_img = $img->save(ABSPATH.'wp-content/uploads/new_file.jpg');

Сохраняет новое изображение и возвращает массив с данными о нём, $save_img['path'] - полный путь до изображения, $save_img['file'] - название файла, $save_img['width'] - ширина и $save_img['height'] - высота изображения.

А теперь полезная функция на основе этого функционала:

function get_img_theme($url, $width, $height){
    $img_name=explode('/', $url);
    $file_url='/wp-content/uploads/'.$img_name[count($img_name)-3].'/'.$img_name[count($img_name)-2].'/';
    $file_name=explode('.', $img_name[count($img_name)-1]);
    $file_name=$file_name[0].'-'.$width.'x'.$height.'.'.$file_name[1];
    if(file_exists($file_url.$file_name))
        return $file_url.$file_name;
    else{
        $image = wp_get_image_editor(ABSPATH.$file_url.$img_name[count($img_name)-1]);
        if ( ! is_wp_error($image)){
            $image->resize($width, $height, true );
            $image->save(ABSPATH.$file_url.$file_name);
            return $file_url.$file_name;
        }
    }
}

function get_img_theme($url, $width, $height){

$img_name=explode('/', $url);

$file_url='/wp-content/uploads/'.$img_name[count($img_name)-3].'/'.$img_name[count($img_name)-2].'/';

$file_name=explode('.', $img_name[count($img_name)-1]);

$file_name=$file_name[0].'-'.$width.'x'.$height.'.'.$file_name[1];

if(file_exists($file_url.$file_name))

return $file_url.$file_name;

else{

$image = wp_get_image_editor(ABSPATH.$file_url.$img_name[count($img_name)-1]);

if ( ! is_wp_error($image)){

$image->resize($width, $height, true );

$image->save(ABSPATH.$file_url.$file_name);

return $file_url.$file_name;

}

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

SEO

Простые редиректы в WordPress

31.01.2014 Profer Оставить комментарий

Иногда бывает нужно сделать редиректы в самом WordPress. Для этого существует функция wp_redirect, которая используется следующим образом:

wp_redirect( 'http://www.example.com/page.html', 301 );

1	wp_redirect( 'http://www.example.com/page.html', 301 );

Первым аргументом функции указывается куда производиться редирект, а второй - статус код.

Функция очень полезная, но если у вас используется кеширующий плагин и эту функцию просто вставить в код темы, то плагин закеширует эти данные, и в итоге всё-равно получится страница с кодом 200, а не 301-ым редиректом. Тут нам поможет хук template_redirect:

add_action( 'template_redirect', 'my_redirect', 1 );

1	add_action( 'template_redirect', 'my_redirect', 1 );

Здесь вызывается наша функция my_redirect перед тем, как будет загружен шаблон сайта. Последнее число в примере обозначает приоритет выполнения, чем выше число, тем позже выполнится функция. Теперь осталось написать функцию my_redirect, которая будет отвечать за условия редиректа и вставить это всё в function.php нашей темы. Ниже я приведу пример:

function my_redirect(){
    global $post;    
    if(is_single()){
        $post_url=get_permalink($post->ID);
        if($post_url!='http://'.$_SERVER['HTTP_HOST'].$_SERVER['REQUEST_URI']){
            wp_redirect($post_url, 301 ); exit;
        }
    }
}
add_action( 'template_redirect', 'my_redirect', 9);

function my_redirect(){

global $post;

if(is_single()){

$post_url=get_permalink($post->ID);

if($post_url!='http://'.$_SERVER['HTTP_HOST'].$_SERVER['REQUEST_URI']){

wp_redirect($post_url, 301 ); exit;

}

add_action( 'template_redirect', 'my_redirect', 9);

В данном примере я делаю редирект с неправильного URL-а поста на правильный, это бывает необходимо в том случае, если по какой-либо причине у вас где-нибудь просочился не верный URL. Например ссылка "www.example.com/my_category/post.html/123" будет открываться так же, как и "www.example.com/post.html", что не очень хорошо, особенно для поисковиков, ведь по сути это дубль. Таким образом можно задать автоматические условия для перенаправления на правильные URL-ы.

Копаемся в WordPress и не только