HUSKY - Product Filter for WooCommerce

Как добавить JSON-LD разметку на страницы SEO URL HUSKY

Проблема

Поле “SEO URL request” в фильтрах HUSKY <script> теги из соображений безопасности, предотвращая прямое внедрение структурированных данных JSON-LD (разметка schema) для расширенных результатов Google.

Обзор решения

Вместо того чтобы вставлять полный код JSON-LD непосредственно в поле SEO-текста, используйте ключи схемы в админке HUSKY и храните фактический код JSON-LD в отдельных файлах или functions.php.


Метод 1: Статические JSON-файлы (Рекомендуется для простых схем)

Шаг 1: Создайте папку для файлов схемы

  • Перейдите в /wp-content/uploads/
  • Создайте новую папку: json-ld-schemas

Шаг 2: Создайте JSON-файлы схемы

  • Создайте файлы, такие как category1.json, products.jsonи т.д.
  • Внутри каждого файла добавьте чистый JSON-LD код (без <script> тегов):
    {
        "@context": "https://schema.org", 
        "@type": "CollectionPage", 
        "name": "Product Category", 
        "description": "Category description"
    }

Шаг 3: Добавьте этот код в functions.php:

add_action('init', function () {
    $url_request = WOOF_EXT::$includes['applications']['url_request'];
    remove_filter('woocommerce_after_shop_loop', array($url_request->seo, 'add_seo_text'), 99999);
    
    add_filter('woocommerce_after_shop_loop', function () use ($url_request) {
        $rule = $url_request->seo->check_search_rules();
        if (!isset($rule['text']) || !$url_request->seo->do_index()) {
            return;
        }
        
        $schema_key = apply_filters('woof_seo_text', $url_request->seo->replace_vars($rule['text'], $url_request->seo->get_current_replace_vars()));
        
        if (!empty($schema_key)) {
            $upload_dir = wp_upload_dir();
            $schemas_dir = $upload_dir['basedir'] . '/json-ld-schemas/';
            $schema_file = $schemas_dir . $schema_key . '.json';
            
            if (file_exists($schema_file)) {
                $json_content = file_get_contents($schema_file);
                echo '<div class="woof_seo_text"><script type="application/ld+json">' . $json_content . "</script></div>\r\n";
            }
        }
    }, 99999);
}, 1);

Шаг 4: В админке HUSKY (SEO URL request → поле SEO text)

  • Введите только ключ схемы (например, category1)
  • НЕ вводите полный код JSON-LD

Метод 2: Динамические PHP-файлы (Для динамических схем)

Шаг 1: Создайте PHP-файлы схемы в /wp-content/uploads/json-ld-schemas/

Пример: category-dynamic.php

<?php
global $wp_query;

$term = get_queried_object();
$category_name = $term ? $term->name : 'Products';
$category_url = get_term_link($term);

$schema = array(
    '@context' => 'https://schema.org',
    '@type' => 'CollectionPage',
    'name' => $category_name,
    'url' => $category_url,
    'description' => term_description($term->term_id),
    'breadcrumb' => array(
        '@type' => 'BreadcrumbList',
        'itemListElement' => array(
            array(
                '@type' => 'ListItem',
                'position' => 1,
                'name' => 'Home',
                'item' => home_url()
            ),
            array(
                '@type' => 'ListItem',
                'position' => 2,
                'name' => $category_name,
                'item' => $category_url
            )
        )
    )
);

return $schema;

Step 2: Add this code to functions.php:

add_action('init', function () {
    $url_request = WOOF_EXT::$includes['applications']['url_request'];
    remove_filter('woocommerce_after_shop_loop', array($url_request->seo, 'add_seo_text'), 99999);
    
    add_filter('woocommerce_after_shop_loop', function () use ($url_request) {
        $rule = $url_request->seo->check_search_rules();
        if (!isset($rule['text']) || !$url_request->seo->do_index()) {
            return;
        }
        
        $schema_key = apply_filters('woof_seo_text', $url_request->seo->replace_vars($rule['text'], $url_request->seo->get_current_replace_vars()));
        
        if (!empty($schema_key)) {
            $upload_dir = wp_upload_dir();
            $schemas_dir = $upload_dir['basedir'] . '/json-ld-schemas/';
            $schema_file = $schemas_dir . $schema_key . '.php';
            
            if (file_exists($schema_file)) {
                $schema_data = include($schema_file);
                $json_output = json_encode($schema_data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT);
                echo '<div class="woof_seo_text"><script type="application/ld+json">' . $json_output . "</script></div>\r\n";
            }
        }
    }, 99999);
}, 1);

 


Пример использования

В админке HUSKY:

  1. Перейдите в настройки “SEO URL request”
  2. Создайте правило для конкретной комбинации фильтров
  3. В поле “SEO text” введите только: category-dynamic (или любое другое название ключа)
  4. Сохранить

Результат:

  • Файл схемы /wp-content/uploads/json-ld-schemas/category-dynamic.php будет загружен
  • JSON-LD будет правильно отрисован в исходном коде страницы
  • Google сможет читать и проверять структурированные данные


Важные замечания

  • Используйте только ключи в поле SEO text админки HUSKY (например, products, category1)
  • Никогда не вставляйте полный код JSON-LD напрямую в админку HUSKY
  • Для статических схем → используйте .json файлы
  • Для динамических схем → используйте .php файлы, которые возвращают массив
  • Очистите кэш после внесения изменений

Проверка

После реализации проверьте вашу схему:

  1. Посетите отфильтрованную страницу на вашем сайте
  2. Скопируйте URL страницы
  3. Протестируйте на: https://search.google.com/test/rich-results
  4. Проверьте наличие ошибок