{"id":12981,"date":"2026-09-12T18:25:00","date_gmt":"2026-09-12T16:25:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/blog\/?p=12981"},"modified":"2026-10-26T12:43:44","modified_gmt":"2026-10-26T11:43:44","slug":"tutorial-jak-znalezc-wolne-meta_query-i-przepisac-je-na-filtr-taksonomii","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/pl\/wordpress-plugins-tricks-pl\/tutorials-pl-wordpress-plugins-tricks-pl\/tutorial-jak-znalezc-wolne-meta_query-i-przepisac-je-na-filtr-taksonomii\/","title":{"rendered":"Tutorial: Jak znale\u017a\u0107 wolne meta_query i przepisa\u0107 je na filtr taksonomii"},"content":{"rendered":"

Taksonomia przypisuje produkty do nazwanych cech, takich jak kolor lub materia\u0142. Wolny filtr produkt\u00f3w wymaga pomiaru przed zmian\u0105 modelu danych. meta_query<\/code> mo\u017ce by\u0107 w\u0142a\u015bciwym rozwi\u0105zaniem, a taksonomia mo\u017ce pom\u00f3c przy filtrowaniu kategorii. Sama liczba z\u0142\u0105cze\u0144 ani r\u00f3\u017cnych warto\u015bci nie wskazuje szybszego wariantu. Najpierw nowa kwerenda musi nadal wybiera\u0107 te same produkty.<\/p>\n

1. Zachowanie ca\u0142ego filtra<\/h2>\n

Przyk\u0142ad wyszukuje opublikowane produkty o kolorze blau<\/code>, materiale eiche<\/code> i dost\u0119pno\u015bci 1<\/code>. Oba warianty musz\u0105 zachowa\u0107 trzy warunki, kolejno\u015b\u0107 i podzia\u0142 na strony. Dost\u0119pno\u015b\u0107 pozostaje tutaj warunkiem metadanych.<\/p>\n

<?php\n$base = [\n    'post_type' => 'produkt',\n    'post_status' => 'publish',\n    'posts_per_page' => 20,\n    'paged' => 1,\n    'orderby' => ['date' => 'DESC', 'ID' => 'DESC'],\n];\n$before = new WP_Query($base + [\n    'meta_query' => [\n        'relation' => 'AND',\n        ['key' => 'farbe', 'value' => 'blau'],\n        ['key' => 'material', 'value' => 'eiche'],\n        ['key' => 'verfuegbar', 'value' => '1'],\n    ],\n]);\n$after = new WP_Query($base + [\n    'tax_query' => [\n        'relation' => 'AND',\n        ['taxonomy' => 'farbe', 'field' => 'slug',\n         'terms' => ['blau'], 'include_children' => false],\n        ['taxonomy' => 'material', 'field' => 'slug',\n         'terms' => ['eiche'], 'include_children' => false],\n    ],\n    'meta_query' => [\n        ['key' => 'verfuegbar', 'value' => '1'],\n    ],\n]);\n\/\/ SQL: $before->request and $after->request\n<\/code><\/pre>\n
Kod zak\u0142ada istniej\u0105cy w\u0142asny typ wpisu produkt<\/code> oraz obie taksonomie z poprawnymi przypisaniami. Nie jest to zapytanie WooCommerce. Por\u00f3wnanie wykonuje dwa zapytania; aplikacja korzysta\u0142aby z wybranego wariantu. Kontrola zgodno\u015bci musi obejmowa\u0107 wszystkie istotne strony i kombinacje filtr\u00f3w, a nie tylko pierwszych dwadzie\u015bcia wynik\u00f3w.<\/p>\n
\"Zachowanie
Zachowanie warunk\u00f3w filtra i kontrola migracji<\/figcaption><\/figure>\n
2. Kontrola rzeczywistego SQL i planu<\/h2>\n
$query->request<\/code> zawiera wygenerowany SQL. Trzy dodatnie warunki metadanych po\u0142\u0105czone przez AND zwykle wymagaj\u0105 w tym przyk\u0142adzie trzech z\u0142\u0105cze\u0144. Nie istnieje jednak uniwersalna zasada \u201ejedna klauzula, jedno z\u0142\u0105czenie\u201d: zgodne klauzule OR mog\u0105 wsp\u00f3\u0142dzieli\u0107 alias. Logiczne aliasy nie s\u0105 fizycznymi kopiami tabeli bazy danych.<\/p>\n
Standardowy schemat WordPressa indeksuje post_id<\/code> i prefiks meta_key<\/code>, lecz nie meta_value<\/code>. Konkretna instalacja mo\u017ce mie\u0107 dodatkowe indeksy. Optymalizator mo\u017ce rozpocz\u0105\u0107 od tabeli wpis\u00f3w lub innej \u015bcie\u017cki dost\u0119pu; nie zawsze przegl\u0105da wszystkie wiersze danego klucza. Powielone metadane mog\u0105 zwi\u0119ksza\u0107 wyniki po\u015brednie.<\/p>\n
W chronionym wywo\u0142aniu deweloperskim SAVEQUERIES<\/code> zapisuje SQL, czas wykonania i informacje o wywo\u0142aniu. Zwi\u0119ksza zu\u017cycie pami\u0119ci i obci\u0105\u017cenie; logi mog\u0105 zawiera\u0107 poufne warto\u015bci. Dziennik wolnych zapyta\u0144 bazy daje inn\u0105 perspektyw\u0119 i nie dostarcza tej samej \u015bcie\u017cki wywo\u0142a\u0144 PHP. W\u0142\u0105czenie wymaga odpowiednich uprawnie\u0144, ograniczonego czasu pomiaru i oceny ilo\u015bci log\u00f3w. Zmiana globalnej warto\u015bci domy\u015blnej sesji nie aktualizuje wszystkich istniej\u0105cych po\u0142\u0105cze\u0144.<\/p>\n
EXPLAIN<\/code> przedstawia plan szacunkowy. rows<\/code> i filtered<\/code> wymagaj\u0105 wsp\u00f3lnej interpretacji z kolejno\u015bci\u0105 z\u0142\u0105cze\u0144, typem dost\u0119pu i wybranymi indeksami. Du\u017ce oszacowanie nie dowodzi nieskuteczno\u015bci filtra. Using filesort<\/code> oznacza dodatkowe sortowanie, niekoniecznie na dysku. Using temporary<\/code> samo w sobie nie dowodzi z\u0142ego zapytania. MySQL EXPLAIN ANALYZE<\/code> rzeczywi\u015bcie wykonuje instrukcj\u0119; sk\u0142adnia i zachowanie MariaDB wymagaj\u0105 osobnej kontroli.<\/p>\n
meta_value_num<\/code> sortuje liczbowo. WordPress u\u017cywa wyra\u017cenia numerycznego, a nie por\u00f3wnania tekstu. Wyra\u017cenia i du\u017ce wyniki po\u015brednie mog\u0105 zwi\u0119ksza\u0107 koszt, lecz wcze\u015bniejsze twierdzenie o zwykle wi\u0119kszym koszcie sortowania ni\u017c wszystkich filtr\u00f3w nie mia\u0142o podstawy pomiarowej.<\/p>\n
3. Rejestracja obu cech kategorialnych<\/h2>\n
<?php\nadd_action('init', function () {\n    foreach (['farbe', 'material'] as $taxonomy) {\n        register_taxonomy($taxonomy, ['produkt'], [\n            'hierarchical' => false,\n            'public' => false,\n            'publicly_queryable' => false,\n            'show_ui' => true,\n            'show_admin_column' => true,\n            'show_in_rest' => false,\n            'query_var' => false,\n            'rewrite' => false,\n        ]);\n    }\n});\n<\/code><\/pre>\n
Rejestrowane s\u0105 zar\u00f3wno farbe<\/code>, jak i material<\/code>. Przyk\u0142ad wy\u0142\u0105cza publiczne zapytania taksonomii i regu\u0142y adres\u00f3w, zachowuj\u0105c zarz\u0105dzanie. Nie tworzy to kontroli dost\u0119pu. Edytor blokowy wymaga odpowiedniej konfiguracji REST, w tym show_in_rest<\/code>; udost\u0119pnianie danych i uprawnienia REST wymagaj\u0105 osobnej decyzji.<\/p>\n
term_relationships<\/code> zawiera identyfikator obiektu, identyfikator terminu taksonomii i kolejno\u015b\u0107 terminu. Z\u0142o\u017cony klucz g\u0142\u00f3wny zaczyna si\u0119 od ID obiektu, a osobny indeks od ID terminu taksonomii. Te \u015bcie\u017cki dost\u0119pu mog\u0105 pomaga\u0107 w dok\u0142adnym dopasowaniu kategorii. Indeks z\u0142o\u017cony nie dzia\u0142a automatycznie r\u00f3wnie dobrze od obu ko\u0144c\u00f3w. Cecha tak\u2013nie nie jest z zasady nieodpowiednia dla taksonomii. Status publikacji nie powinien zmienia\u0107 znaczenia wy\u0142\u0105cznie po to, by oznacza\u0107 dost\u0119pno\u015b\u0107 magazynow\u0105.<\/p>\n
4. Plan migracji przed zapisem<\/h2>\n
Poni\u017cszy plan.php<\/code> wy\u0142\u0105cznie odczytuje dane. Zawiera dwa przyk\u0142adowe ID i jawne mapowanie warto\u015bci; obie listy wymagaj\u0105 dostosowania do faktycznych danych. Docelowe terminy musz\u0105 ju\u017c istnie\u0107. Nieznane, puste, powielone lub z\u0142o\u017cone metadane zatrzymuj\u0105 plan zamiast cicho gubi\u0107 informacje. Puste warto\u015bci wymagaj\u0105 okre\u015blonej polityki: zachowania przypisania, usuni\u0119cia albo skierowania do kontroli.<\/p>\n
<?php\n\/\/ Read-only example for reviewed IDs, not a complete migration runner.\n$ids = [101, 102];\n$mapping = [\n    'farbe' => ['blau' => 'blau', 'rot' => 'rot'],\n    'material' => ['eiche' => 'eiche', 'buche' => 'buche'],\n];\n$plan = [];\nforeach ($ids as $id) {\n    if (get_post_type($id) !== 'produkt') {\n        throw new RuntimeException("Unexpected post type: $id");\n    }\n    foreach ($mapping as $taxonomy => $values) {\n        if (!taxonomy_exists($taxonomy)) {\n            throw new RuntimeException("Missing taxonomy: $taxonomy");\n        }\n        $raw = get_post_meta($id, $taxonomy, false);\n        if (count($raw) !== 1 || !is_string($raw[0])\n            || !array_key_exists($raw[0], $values)) {\n            throw new RuntimeException("Unmapped or ambiguous value: $id\/$taxonomy");\n        }\n        $term = get_term_by('slug', $values[$raw[0]], $taxonomy);\n        if (!$term || is_wp_error($term)) {\n            throw new RuntimeException("Missing target term: $id\/$taxonomy");\n        }\n        $old = wp_get_object_terms($id, $taxonomy, ['fields' => 'ids']);\n        if (is_wp_error($old)) {\n            throw new RuntimeException($old->get_error_message());\n        }\n        $plan[] = [\n            'post_id' => $id,\n            'taxonomy' => $taxonomy,\n            'source_value' => $raw[0],\n            'old_term_ids' => array_map('intval', $old),\n            'new_term_ids' => [(int) $term->term_id],\n        ];\n    }\n}\necho wp_json_encode($plan, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);\n<\/code><\/pre>\n
wp eval-file plan.php<\/code> wypisuje proponowane przypisania. Nie zmienia termin\u00f3w ani metadanych. Pe\u0142na migracja wymaga ponadto ograniczonych partii, kopii warto\u015bci \u017ar\u00f3d\u0142owych i starych przypisa\u0144, przerwy w zapisie albo synchronizacji wszystkich \u017ar\u00f3de\u0142 zmian oraz sprawdzonego wznawiania.<\/p>\n
Po kontroli planu i ponownym por\u00f3wnaniu bie\u017c\u0105cych warto\u015bci oraz starych przypisa\u0144 poni\u017cszy fragment API stosuje jeden wiersz. Ca\u0142kowite ID termin\u00f3w zapobiegaj\u0105 pomyleniu z nazwami sk\u0142adaj\u0105cymi si\u0119 z cyfr. Argument false zast\u0119puje przypisania w tej taksonomii, wi\u0119c dotychczasowe terminy mog\u0105 znikn\u0105\u0107.<\/p>\n
<?php\n\/\/ Fragment for one previously reviewed and revalidated plan row.\n$result = wp_set_object_terms(\n    (int) $row['post_id'],\n    array_map('intval', $row['new_term_ids']),\n    $row['taxonomy'],\n    false\n);\nif (is_wp_error($result)) {\n    throw new RuntimeException($result->get_error_message());\n}\n\/\/ Read back term IDs and compare them with new_term_ids.\n<\/code><\/pre>\n
Fragment nie wykonuje wszystkich zmian jako jednej operacji, kt\u00f3ra albo ko\u0144czy si\u0119 w ca\u0142o\u015bci, albo zostaje w ca\u0142o\u015bci cofni\u0119ta. Ka\u017cdy zapis wymaga ponownego odczytu i obs\u0142ugi b\u0142\u0119d\u00f3w; p\u00f3\u017aniejsza awaria nie cofa automatycznie wcze\u015bniejszych wierszy. Stary plan mo\u017ce nadpisa\u0107 nowsze zmiany taksonomii. Automatyczna normalizacja slugu mo\u017ce po\u0142\u0105czy\u0107 r\u00f3\u017cne warto\u015bci \u017ar\u00f3d\u0142owe, dlatego mapowanie jest jawne.<\/p>\n
5. Weryfikacja przed wycofaniem metadanych<\/h2>\n
Por\u00f3wnanie obejmuje ID wynik\u00f3w, kolejno\u015b\u0107, liczby trafie\u0144, brakuj\u0105ce warto\u015bci, powielone metadane, szkice i wpisy zaplanowane w zakresie migracji oraz ewentualne przypisania wieloj\u0119zyczne. Pomiar czasu wymaga por\u00f3wnywalnych danych, indeks\u00f3w, pami\u0119ci podr\u0119cznej i obci\u0105\u017cenia. Dla wcze\u015bniejszych liczb 480 000 wobec 2 100 przegl\u0105danych wierszy na grafice nie ma odtwarzalnego pomiaru.<\/p>\n
Wcze\u015bniejsze polecenie wp post meta delete --all --keys=farbe --dry-run<\/code> by\u0142o niepoprawne dla tego zadania. Udokumentowane polecenie wymaga ID obiektu; --all<\/code> oznacza wszystkie metadane tego obiektu, a taki prze\u0142\u0105cznik dry-run nie jest udokumentowany. Stare metadane powinny pozosta\u0107 do wyja\u015bnienia zapis\u00f3w, por\u00f3wna\u0144 i mo\u017cliwo\u015bci powrotu. Czyszczenie wymaga osobnego, jawnego zakresu oraz kopii danych.<\/p>\n
\n
Pytania i odpowiedzi<\/h2>\n
Kiedy inny model danych jest korzystniejszy?<\/h3>\n
Zakresy liczbowe mog\u0105 korzysta\u0107 z typowanych indeksowanych kolumn lub istniej\u0105cej tabeli pomocniczej. Ma\u0142e lub selektywne zapytania metadanych mog\u0105 ju\u017c dzia\u0142a\u0107 szybko. Ani tysi\u0105ce termin\u00f3w, ani kilka pasuj\u0105cych wierszy nie wyznaczaj\u0105 uniwersalnego progu. Indeksy pe\u0142notekstowe dziel\u0105 tekst na tokeny i nie obs\u0142uguj\u0105 automatycznie dowolnych fragment\u00f3w s\u0142owa.<\/p>\n
Co zmienia WooCommerce?<\/h3>\n
Najpierw potrzebna jest kontrola istniej\u0105cych atrybut\u00f3w, regu\u0142 widoczno\u015bci i tabel pomocniczych. Typ produktu i interfejsy danych WooCommerce r\u00f3\u017cni\u0105 si\u0119 od fikcyjnego przyk\u0142adu. R\u00f3wnoleg\u0142a w\u0142asna taksonomia nie mo\u017ce omija\u0107 magazynu, widoczno\u015bci, t\u0142umacze\u0144 ani dzia\u0142ania rozszerze\u0144.<\/p>\n<\/div>\n
\u0179r\u00f3d\u0142a<\/h2>\n