Konstans, szűrők, REST és abilities

wp-config-konstans

Konstans	Mit csinál
LW_PIXEL_CHATGPT_API_KEY	A ChatGPT Ads Conversions API kulcsa. Ha nem üres, elsőbbséget élvez a felületen mentett kulccsal szemben, és nem kerül az adatbázisba. A felületen ilyenkor nem módosítható.

wp-config.php

define( 'LW_PIXEL_CHATGPT_API_KEY', 'xxxx' );

Bedrockban a szokásos módon: a .env-be LW_PIXEL_CHATGPT_API_KEY=xxxx, a config/application.php-ba:

config/application.php

Config::define( 'LW_PIXEL_CHATGPT_API_KEY', env( 'LW_PIXEL_CHATGPT_API_KEY' ) );

A Meta-tokennek és a GA4 MP API-titoknak nincs konstansa, ezek csak az adatbázisban tárolhatók. Ha a WP_DEBUG be van kapcsolva, a bővítmény naplózza a szerveroldali küldési hibákat.

Szűrők

Szűrő	Mire jó
lw_pixel_pixel_enabled	Pixel feltételes ki- vagy bekapcsolása (bool $enabled, string $pixel_id).
lw_pixel_event_params	Eseményparaméterek módosítása.
lw_pixel_event_should_fire	Egy esemény letiltása.
lw_pixel_resolve_events	Saját események hozzáadása.
lw_pixel_is_category_allowed	Más hozzájáruláskezelő bekötése, ha nincs LW Cookie. Alapból true: minden fut.
lw_pixel_trust_proxy_headers	true esetén a látogató IP-jét a CF-Connecting-IP / X-Forwarded-For fejlécből veszi. Csak megbízható proxy (pl. Cloudflare) mögött.
lw_pixel_server_page_event	Oldal-szintű esemény szerveroldali küldése gyorsítótárazható oldalon is.
lw_pixel_capi_user_data, lw_pixel_capi_event_body	A Meta Conversion API felhasználói adata és eseménytörzse.
lw_pixel_capi_api_version	A Meta Graph API verziója (alap: v26.0).
lw_pixel_ga4_mp_event	A GA4 Measurement Protocol eseménye.
lw_pixel_chatgpt_capi_event, lw_pixel_chatgpt_browser_user	A ChatGPT Ads szerveroldali eseménye és böngészős felhasználói adata.
lw_pixel_capi_purchase_consent, lw_pixel_server_purchase_consent	Szerveroldali vásárlás engedélyezése rendelésenként.
lw_pixel_barion_email_hash	A Barion e-mail-hash.
lw_pixel_server_providers	Saját szerveroldali szolgáltató.
lw_pixel_migrators	Saját importer regisztrálása.

Lekérdezhető értékek: apply_filters( 'lw_pixel_active_pixels', [] ) a beállított pixeleket, a lw_pixel_consent_state a kategóriánkénti hozzájárulást adja.

Akciók: lw_pixel_register_pixels (saját pixel), lw_pixel_server_response ($provider, $ok, $status: a szerveroldali küldés eredménye, pl. riasztáshoz).

PHP-ból egy beállítás: \LightweightPlugins\Pixel\Options::get( 'fb_pixel_id' ).

REST-végpontok

A REST a beállítóképernyő belső API-ja, lw-pixel/v1 névtérben. Minden útvonal adminisztrátori jogot (manage_options) kér.

Metódus	Útvonal	Mit csinál
GET	/wp-json/lw-pixel/v1/admin/settings	Beállítások; titkok helyett csak az állapotuk.
POST	/wp-json/lw-pixel/v1/admin/settings	Részleges mentés, a felülettel azonos ellenőrzéssel. Hibás mezőnél semmi nem mentődik.
GET, POST	/wp-json/lw-pixel/v1/admin/custom-events	Egyéni események listája, új esemény.
GET, POST, DELETE	/wp-json/lw-pixel/v1/admin/custom-events/{id}	Egy esemény lekérése, módosítása, törlése.
GET	/wp-json/lw-pixel/v1/admin/migrators	Importerek és előnézet.
POST	/wp-json/lw-pixel/v1/admin/migrators/pys/run	PixelYourSite-import.
GET	/wp-json/lw-pixel/v1/admin/system-report	Rendszerjelentés.
POST	/wp-json/lw-pixel/v1/admin/test/chatgpt	ChatGPT Ads kapcsolatteszt ({ ok, status, message }).

Titok-mezőknél POST-ban: null = marad, "" = törlés, más szöveg = csere.

Meta pixel bekapcsolása azonosítóval

curl -u "admin:xxxx xxxx xxxx xxxx xxxx xxxx" -X POST \
  -H "Content-Type: application/json" \
  -d '{"fb_enabled":true,"fb_pixel_id":"1234567890"}' \
  https://pelda.hu/wp-json/lw-pixel/v1/admin/settings

Abilities (az LW Site Manager mellett)

Ha az LW Site Manager is aktív, három képesség jelenik meg „Követőpixelek” kategóriában. Adminisztrátori jog kell.

Ability	Mit csinál
lw-pixel/get-options	Pixelbeállítások lekérése; a titkok ********-ként.
lw-pixel/set-options	Pixelbeállítások módosítása. Válasz: „… beállítás frissítve.”
lw-pixel/list-pixels	Pixelek listázása.

A WordPress Abilities REST-felületén hívhatók: /wp-json/wp-abilities/v1/abilities/<név>/run, olvasáshoz GET, íráshoz POST {"input": {...}} törzzsel.

GA4 bekapcsolása

curl -u "admin:xxxx xxxx xxxx xxxx xxxx xxxx" -X POST \
  -H "Content-Type: application/json" \
  -d '{"input":{"options":{"ga4_enabled":true,"ga4_measurement_id":"G-ABC1234"}}}' \
  https://pelda.hu/wp-json/wp-abilities/v1/abilities/lw-pixel/set-options/run

A set-options nem ellenőriz

Az ismeretlen kulcsot csendben eldobja, a formátumot nem ellenőrzi. Utána nézd meg a beállítást a felületen.