Как найти все сайты на wordpress

Функция позволяет получить сайты сети WordPress Мультисайт, соответствующие переданным в неё параметрам.

Мы уже рассматривали с вами подобные функции, например:

• get_terms() – для таксономий,
• get_posts() – для постов

Теперь пришло время познакомиться с функцией, предназначенной для получения / вывода сайтов сети.

get_sites( $args = array() )

Как работать с функцией get_sites() ?

Функция возвращает нам массив объектов WP_Site (если только не заданы параметры count или fields), например:

$sites = get_sites();
 
print_r( $sites );
 
/*
Array
(
	[0] => WP_Site Object
		(
			[blog_id] => 1
			[domain] => misha.blog
			[path] => /
			[site_id] => 1
			[registered] => 2020-01-07 22:14:23
			[last_updated] => 2020-01-13 09:06:55
			[public] => 1
			[archived] => 0
			[mature] => 0
			[spam] => 0
			[deleted] => 0
			[lang_id] => 0
		)
 
	[1] => WP_Site Object
		(
			[blog_id] => 2
			[domain] => misha.blog
			[path] => /surf/
			[site_id] => 1
			[registered] => 2020-01-07 19:15:56
			[last_updated] => 2020-01-13 09:08:43
			[public] => 0
			[archived] => 0
			[mature] => 1
			[spam] => 0
			[deleted] => 0
			[lang_id] => 0
		)
)
*/

В качестве примера давайте выведем ссылки на все сайты сети:

$sites = get_sites();
foreach( $sites as $site ){
	echo '<a href="' . $site->domain . $site->path . '">' . get_blog_details( $site->blog_id )->blogname . '</a>';
}

Параметры функции

Функция имеет немало параметров (с WP_Query конечно не сравнится), которые позволяют нам четко задать, какие конкретно сайты сети мультисайт мы хотим получить.

site__in

(массив|целое число) Если при помощи функции get_sites() вы хотите получить определённые сайты сети и вы знаете их ID, то передайте айдишники в этот параметр в виде массива. Например array( 1, 5, 10 ), либо, если значение одно, то можете передать его в виде целого числа.

По умолчанию: пустая строка.

site__not_in

(массив|целое число) Например, вы хотите исключить из запроса только текущий сайт (т.е. только тот, на котором вы используете в данный момент функцию), тогда вы можете передать параметр следующим образом:

$sites = get_sites( array( 
	'site__not_in' => get_current_blog_id()
) );

Как видите, я воспользовался функцией get_current_blog_id() для получения ID текущего сайта сети и даже не стал закидывать её в массив.

По умолчанию: пустая строка.

count

Если вы установите этот параметр равным true (по умолчанию false), то функция вернет вам лишь одно целое число – количество сайтов, удовлетворяющих всем остальным значениям параметров.

date_query

Как и посты, мы можем очень детально фильтровать получение сайтов по дате. Вэйт, вэйт, какая дата имеется ввиду в этом случае? Дата регистрации сайта конечно же! 😁

Подробнейшие примеры по работе с date_query вы сможете найти тут.

fields

В каком формате вы хотите ожидать ответ от функции? Как вы помните, я уже сказал чуть выше, что функция возвращает массив объектов WP_Site. Данный параметр позволяет изменить это и вернуть (пока что) только ID удовлетворяющих условиям сайтов. Для этого передайте в него значение: ids.

Ну хорошо, уговорили, пример:

$sites = get_sites( array( 'fields' => 'ids' ) );
/*
 Результат:
 Array
 (
    [0] => 11
    [1] => 251
 )
*/

ID

(целое число) Укажите ID конкретного сайта, который хотите получить.

В чем отличие от site__in ? Без понятия. Если кто знает, велкам в комментарии, обсудим. Кстити говоря, оба параметра – и ID и site__in допускают возможность использования других параметров! Что это значит – если вы указали параметр archived равный единице и передали в параметр ID сайт, который НЕ заархивирован, то функция вернёт пустой массив, о да.

number

(целое число) Тут всё легко – укажите максимальное число сайтов, которые хотите получить.

По умолчанию – Сотня.

offset

(целое число) И тут всё нам должно быть знакомо. Сколько сайтов с начала нужно пропустить. Например если вы укажете offset равным 2, а всего найдено сайтов 5, то будут получены последние 3 сайта.

orderby

(строка|массив) Вот тут и начинают получать смысл наши параметры number и offset. Ведь теперь вы можете выбрать, в каком порядке отображать возвращаемые сайты, параметр может принимать значения:

• id (по умолчанию)
• domain – по доменному имени (в случае если подсайты – на поддоменах/доменах),
• path – по пути (в случае если мультисайт установлен в поддиректории),
• last_updated – сайты сети, в которых недавно были добавлены посты,
• registered – по дате регистрации сайтов,
• domain_length – по длине доменного имени,
• path_length – по длине пути,
• site__in – по порядку, указанному в параметре site__in.

Параметр также принимает значение false, пустой массив или none, если вы хотите вообще отключить в SQL запросе кусок ORDER BY.

Также вы можете указать например два значения orderby в виде массива, тогда сортировка будет сначала по первому параметру, а потом по второму:

$sites = get_sites( array(  
	'orderby' => array( 'registered', 'domain' ) 
	// сначала по дате регистрации, потом по доменному имени
) );

order

(строка) Порядок сортировки:

• ASC – по возрастанию (по умолчанию)
• DESC – по убыванию

domain

(строка) Ограничить получаемые функцией результаты определённым доменом.

domain__in

(массив) Укажите список доменов в виде массива, которые хотите включить в возвращаемые результаты функции.

domain__not_in

(массив) Укажите список доменов в виде массива, которые нужно исключать.

path

(строка) Укажите путь сайта, который хотите получить, если вы не уверены, как оно должно выглядеть, можете найти намёки в таблице wp_blogs в базе данных, не забывайте также слеши в начале и в конце.

path__in

(массив) Список путей сайтов, которые включить в результат.

path__not_in

(массив) Список путей сайтов, которые вы хотите исключить из результата.

public

(целое число) Если указать 1 (по умолчанию), то возвращает все открытые сайты, 0 – закрытые. true/false тут не робят!

По умолчанию null – то есть и открытые и закрытые.

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

• Галочка «Открыто» не отмечена
• Заархивирован
• Спам
• Удалён
• Для взрослых

Во всех остальных случаях сайт считается открытым.

archived

(целое число) Это уже более частные случаи, 1 – возвращает заархивированные сайты, 0 – не заархивированные. По умолчанию null – то есть и те и другие.

mature

(целое число) 1 – сайты, отмеченные как «Для взрослых», 0 – не отмеченные. По умолчанию null – то есть и те и другие.

spam

(целое число) 1 – сайты, отмеченные как спам, 0 – не отмеченные. По умолчанию null – то есть и те и другие.

deleted

(целое число) 1 – деактивированные сайты, 0 – не деактивированные. По умолчанию null – то есть и те и другие.

lang_id

(целое число) Можно ограничить получаемые результаты запроса значением колонки lang_id в таблице wp_blogs. Обратите внимание, что оно не является фактическим языком сайта. И я так понимаю, пока что даже не используется в ядре WordPress. Параметр добавлен в WordPress версии 4.8.

lang__in

(массив) Укажите значения колонки lang_id, которыми вы хотите ограничить результаты запроса. С версии 4.8.

lang__not_in

(массив) Укажите значения колонки lang_id, которые вы хотите исключить из результатов запроса. С версии 4.8.

search

(строка) Укажите часть домена или пути, по которым нужно искать сайты

search_columns

(массив) Массив, содержащий одно или оба следующих значений: domain, path – то, по чему производить поиск в параметре search.

$args = array(
	'search' => 'misha.blog',
	'search_columns' => array( 'domain' )
);
$sites = get_sites( $args );

meta_query

С тех пор, как в версии WordPress 5.1 появилась поддержка мета данных для сайтов сети мультисайт, мы можем запускать и meta_query в качестве параметра функции get_sites() 🚀

Про WP_Meta_Query у меня есть отдельный подробный урок, конечно там для постов в контексте WP_Query, но работает оно точно так же!

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

Если вам понравился дизайн чужого сайта на WordPress, то можно легко узнать, какая тема на нем установлена, и внедрить ее на свой ресурс. 

О том, как это сделать, мы и поговорим в сегодняшней статье.

Что такое детектор темы WordPress

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

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

Как узнать тему WordPress сайта вручную

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

Для начала нам нужен сайт, написанный на WordPress. Для примера мы будем использовать new.burn-photo.ru. Зайдите на него и повторите нижеуказанные действия за мной.

1. На главной странице сайта кликаем правой кнопкой мыши по любой области и выбираем «Просмотр кода страницы». Также это действие можно выполнить с помощью комбинации клавиш «CTRL+U».
2. Следующим шагом зажимаем на клавиатуре клавиши «CTRL+F». В результате в верхнем правом углу браузера перед нами отобразится строка запроса – она потребуется нам, чтобы найти нужную информацию о теме сайта.
3. После этого вводим в строку запрос «wp-content/themes» – так мы найдем на странице путь к шаблону, после которого будет указано имя действующей темы веб-ресурса. Обратите внимание на отобразившуюся строку – в ее конце должно быть написано style.css. Это стили, в которых прописана вся информация о теме. Давайте откроем их.
4. В результате перед нами отобразится новая страница, в которой есть строка «Theme Name». Она информирует нас о той теме, которая установлена сейчас на сайте. Здесь же есть строка «Theme URI», где указана ссылка на официальный сайт шаблона.

Как видите, это довольно простой метод поиска установленной темы, но не совсем быстрый, особенно если вы новичок. Ускорить процесс помогут онлайн-детекторы.

7 лучших детекторов тем WordPress

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

Некоторые инструменты предоставляют дополнительные возможности, например, анализ установленных плагинов или проверку редиректов. 

Wpthemedetector

Первый в списке – Wpthemedetector. Это очень простой инструмент, для работы которого от нас потребуется лишь ввести адрес сайта и воспользоваться кнопкой «Experience the magic of WPTD!». В результате будет отображена информация об авторе темы, ее версии, а также лицензии.

Ссылка на ресурс: Wpthemedetector

Wpdetector

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

Ссылка на ресурс: Wpdetector

Theseotools

Theseotools – это многофункциональный инструмент для анализа сайта. С помощью него мы можем не только получить полную информацию об исходной теме, но и проверить тексты на плагиат и грамматические ошибки, сгенерировать карту сайта и сделать многое другое. В общем, если вам нужно провести SEO-анализ сайта, то используйте данный ресурс. 

Ссылка на ресурс: Theseotools

Gochyu

Gochyu – это онлайн-инструмент, позволяющий проверить тему сайта не только на WordPress, но и на других CMS. Сервис также может обнаруживать плагины/приложения.

Ссылка на ресурс: Gochyu

Scanwp

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

Ссылка на ресурс: Scanwp

Isitwp

Isitwp – это мощный инструмент, который сначала определяет, на какой CMS работает сайт, и только потом узнает его тему. Также пользователю предоставляется доступ к обучающим статьям, связанным с WordPress.

Ссылка на ресурс: Isitwp

Codeinwp

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

Ссылка на ресурс: Codeinwp

Расширения Google Chrome для проверки тем

Есть еще один способ узнать тему WP – воспользоваться расширениями для браузера. Алгоритм их использования похож на онлайн-инструменты, но он заметно проще. Все, что потребуется – установить один из плагинов, а затем запустить его на главной странице веб-сайта. Один из популярных вариантов – WordPress Theme Detector and Plugin Detector. 

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

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

Получает сайты сети в виде массива массив с данными сайтов. В параметрах можно указать какие именно сайты мы хотим получить.

Хуков нет.

Возвращает

Массив|int.

• Массив объектов WP_Site.
• Массив id сайтов, если fields = ‘ids’
• Количество сайтов, когда ‘count’ передан как переменная запроса.

Пример того, что может вернуть функция:

Array(
	[0] => WP_Site Object(
		[blog_id]    => 1
		[site_id]    => 1
		[domain]     => example.com
		[path]       => /
		[registered] => 2013-11-08 17:56:46
		[last_updated] => 2013-11-08 18:57:19
		[public]   => 1
		[archived] => 0
		[mature]   => 0
		[spam]     => 0
		[deleted]  => 0
		[lang_id]  => 0
	)

	[1] => WP_Site Object(
		[blog_id] => 2
		...
	)
)

Шаблон использования

$sites = get_sites( array(
	'fields'            => '',
	'ID'                => '',
	'site__in'          => '',
	'site__not_in'      => '',
	'number'            => 100,
	'offset'            => '',
	'no_found_rows'     => true,
	'orderby'           => 'id',
	'order'             => 'ASC',
	'network_id'        => 0,
	'network__in'       => array(),
	'network__not_in'   => array(),
	'domain'            => '',
	'domain__in'        => array(),
	'domain__not_in'    => array(),
	'path'              => '',
	'path__in'          => array(),
	'path__not_in'      => array(),
	'lang_id'           => 0,
	'lang__in'          => array(),
	'lang__not_in'      => array(),
	'public'            => null,
	'archived'          => null,
	'mature'            => null,
	'spam'              => null,
	'deleted'           => null,
	'search'            => '',
	'search_columns'    => array(),
	'count'             => false,
	'date_query'        => null, // See WP_Date_Query
	'update_site_cache' => true,
) );

foreach( $sites as $site ){
	// делаем что либо
}

Использование

get_sites( $args );

$args(строка/массив)

Параметры для получения сайтов в виде массива или строки. Полный список параметров смотрите в коде метода WP_Site_Query::__construct().
По умолчанию: array() (дефолтный массив данных)

Аргументы $args

site__in(массив)

Массив ID сайтов, которые нужно получить.
По умолчанию: ”

site__not_in(массив)

Массив ID сайтов, которые нужно исключить.
По умолчанию: ”

count(логический)

Ставим true когда нужно получить количество найденных сайтов, а не объекты данных этих сайтов.
По умолчанию: false

date_query(массив)

Фильтрация запроса по дате. См. WP_Date_Query.
По умолчанию: null

fields(строка)

Поля которые нужно вернуть в итоговых данных. Может быть: ‘ids’ – вернет только ID сайтов, ” – вернет все данные сайта.
По умолчанию: ”

ID(число)

ID сайта, когда нужно получить только этот сайт.
По умолчанию: ”

number(число)

Ограничение – максимальное количество сайтов которые нужно получить.
По умолчанию: 100

offset(число)

Верхний отступ при получении сайтов. Используется для построения LIMIT части запроса.

Например, если указать тут 10, и всего найдено 20 сайтов, то будут возвращены последние 10, а верхние 10 будут пропущены…
По умолчанию: 0

no_found_rows(логический)

Отключить подсчет найденных строк. Отключит SQL оператор SQL_CALC_FOUND_ROWS.
По умолчанию: true

orderby(строка|массив)

Колонка по которой сортировать полученные сайты. Может быть:

site__in
network__in
domain
last_updated
path
registered
network_id
domain_length
path_length
id

Также можно указать: false, array() или none, чтобы отключить часть запроса ORDER BY.

По умолчанию: ‘id’

order(строка)

Направление сортировки: Может быть: ASC (123, абв) или DESC (321, бва).
По умолчанию: ‘ASC’

network_id(число)

ID сети, сайты которых нужно получить.
По умолчанию: (ID текущей сети)

network__in(массив)

Массив ID сетей, сайты которых нужно получить.
По умолчанию: ”

network__not_in(массив)

Массив ID сетей, сайты которых нужно исключить.
По умолчанию: ”

domain(строка)

Домен сайта, который нужно получить.
По умолчанию: ”

domain__in(массив)

Массив доменов сайтов, которые нужно получить.
По умолчанию: ”

domain__not_in(массив)

Массив доменов сайтов, которые нужно исключить.
По умолчанию: ”

path(строка)

Путь, который должен содержать сайт.
По умолчанию: ”

path__in(массив)

Массив путей, которые могут содержать сайты.
По умолчанию: ”

path__not_in(массив)

Массив путей, которых не может быть у сайтов.
По умолчанию: ”

public(число)

Ограничить выборку только публичными сайтами. Со статусом ‘public’. Может быть: 1 – только публичные сайты или 0 – не публичные сайты.
По умолчанию: null

archived(число)

Ограничить выборку только сайтами в архиве. Может быть: 1 или 0.
По умолчанию: null

mature(число)

Ограничить выборку только зрелыми (mature) сайтами. Может быть: 1 или 0.
По умолчанию: null

spam(число)

Ограничить выборку только сайтами со статусом СПАМ. Может быть: 1 или 0.
По умолчанию: null

deleted(число)

Ограничить выборку только удаленных сайтов. Может быть: 1 или 0.
По умолчанию: null

search(строка)

Поисковой запрос, по которому нужно искать сайты.
По умолчанию: ”

search_columns(массив)

Массив названий колонок по которым нужно производить поиск, если установлен параметр search. Может быть: ‘domain’ или ‘path’.
По умолчанию: array()

lang_id(число) (с WP 4.8)

Ограничивает результат по ID языка.

lang__in(массив) (с WP 4.8)

Массив ID языков сайты с которыми нужно получить.

lang__not_in(массив) (с WP 4.8)

Массив с ID языков сайты с которыми нужно исключить из результата.

update_site_cache(логический)

Нужно ли сбросить кэш для найденных сайтов, если кэш для них уже установлен.
По умолчанию: false

update_site_meta_cache(true/false) (c WP 5.1)

Следует ли обновить кэш метаданных для найденных сайтов.
По умолчанию: true

meta_query(массив) (c WP 5.1)

Добавляет в SQL запрос условие выбора по метаполям (метаданным) сайтов. См. WP_Meta_Query.
По умолчанию: ”

meta_key(строка) (c WP 5.1)

Получить сайты с указанным тут мета ключом. Может использоваться в сочетании с $meta_value.
По умолчанию: ”

meta_value(строка) (c WP 5.1)

Получить сайты с указанным тут значением метаполя. Обычно используется в сочетании с $meta_key.
По умолчанию: ”

meta_type(строка) (c WP 5.1)

Тип данных, к которому будет приведен столбец $meta_value для сравнения. Возможные варианты: см. type в WP_Meta_Query.
По умолчанию: ”

meta_compare(строка) (c WP 5.1)

Оператор сравнения для указанного в $meta_value значения. Возможные варианты: см. compare в WP_Meta_Query.
По умолчанию: ”

Примеры

$sites = get_sites();

foreach( $sites as $site ){

	echo untrailingslashit( $home_scheme . '://' . $site->domain . $site->path );
	echo ' - '. get_blog_details( $site->blog_id )->blogname;
	echo '<br>';

}

• B правой части каждого сообщения есть стрелки ⇧ и ⇩. Не стесняйтесь оценивать ответы. Чтобы автору вопроса закрыть свой тикет, надо выбрать лучший ответ. Просто нажмите значок ✔ в правой части сообщения.