Ugrás a fő tartalomhoz

HelloPack white-label

Mire jó a White-label funkció?​

A white-label funkció lehetővé teszi a fejlesztők és ügynökségek számára, hogy a HelloPack csomagkezelőt a saját márkaidentitásukhoz igazítsák: kicserélhető a plugin neve, logója és a támogatási URL, valamint elrejthetők a hellowp.io-ra mutató külső hivatkozások és a HelloPack saját marketing-tartalmai. Különösen hasznos azoknak, akik végfelhasználó/ügyfél környezetben használják a HelloPack-et és nem akarják mutatni az eredeti brand-et.

Verzió

A NAME, LOGO_URL és SUPPORT_URL konstansok HelloPack Client 3.0.6 verziótól érhetők el. A HELLOPACK_WHITELABEL master switch korábbi verziókban is működött, de csak részleges branding-elrejtést végzett.

Aktiválás​

A white-label funkciót egyetlen konstans kapcsolja be a wp-config.php fájlban:

wp-config.php
define( 'HELLOPACK_WHITELABEL', true );

A sort a /* That's all, stop editing! Happy publishing. */ fölé illeszd be.

Önmagában ez a konstans már:

  • elrejti a HelloPack logót, és helyette a "HelloPack" feliratot mutatja a SPA fejlécében,
  • elrejti a hellowp.io-ra mutató Documentation és Support footer linkeket,
  • elrejti az About oldal "Why HelloWP Package Manager?" és "What HelloPack does" brand-story szekcióit,
  • elrejti a license-aktiváló képernyőn az "Open API Key Generator" gombot (mert hellowp.io-specifikus),
  • törli a plugin leírását, szerzőjét és külső URL-jeit a WordPress plugin listából.

Saját brand beállítása (opcionális konstansok)​

Az alábbi három konstans tetszőlegesen kombinálható — csak amit beállítasz, az íródik felül.

Saját megjelenítendő név​

wp-config.php
define( 'HELLOPACK_WHITELABEL_NAME', 'Acme Updater' );

Ez a név jelenik meg:

  • a WordPress plugin lista oldalán a "HelloPack Client" helyett,
  • a WordPress bal oldali admin menüben a "HelloPack" helyett,
  • a HelloPack admin felület fejlécében (ha nincs egyedi logó megadva),
  • minden olyan szövegben, ami a termékre hivatkozik (pl. "Manage your Acme Updater API connection...", "Browse, install and update plugins from the Acme Updater library.", diagnosztikai header, bug report payload).

Saját logó​

wp-config.php
define( 'HELLOPACK_WHITELABEL_LOGO_URL', 'https://acme.test/wp-content/uploads/acme-logo.svg' );

A megadott URL képe jelenik meg a HelloPack admin felület fejlécében a HelloPack logó helyett. SVG és raszter formátum egyaránt használható; magasság automatikusan 28px-re skálázódik.

Ha nincs megadva LOGO_URL de van NAME, akkor a fejlécben a név szövegként jelenik meg.

Saját support URL​

wp-config.php
define( 'HELLOPACK_WHITELABEL_SUPPORT_URL', 'https://acme.test/support' );

Ezzel a HelloPack admin footer-ben és az About oldalon a Support link a saját URL-edre fog mutatni a https://hellowp.io/hu/tamogatas/ helyett. Ha nem állítod be, a Support link teljesen eltűnik white-label módban (csak a Documentation linkkel együtt rejtjük el).

Teljes konfigurációs példa​

wp-config.php
define( 'HELLOPACK_WHITELABEL', true );
define( 'HELLOPACK_WHITELABEL_NAME', 'Acme Updater' );
define( 'HELLOPACK_WHITELABEL_LOGO_URL', 'https://acme.test/wp-content/uploads/acme-logo.svg' );
define( 'HELLOPACK_WHITELABEL_SUPPORT_URL', 'https://acme.test/support' );

Mit NEM cserél a white-label?​

  • A plugin könyvtárnevét (wp-content/plugins/hellopack-client/) — ez technikai azonosító, megváltoztatása megszakítaná a frissítéseket.
  • A REST API namespace-t (/wp-json/hellopack/v1/...) — kompatibilitás miatt fix.
  • Az API token forrását — a token továbbra is a hellowp.io-n generálódik (kivéve, ha külön agency/reseller flow-t használtok). A licenc-aktiváló képernyőn csak az "Open API Key Generator" gomb tűnik el, a tokent kézzel be kell illeszteni.

Szöveg-szintű finomhangolás (fordítással)​

Ha a fent felsorolt konstansokon túl is finomítani szeretnél (pl. konkrét feliratokat átírni magyarul vagy a saját márkára), azt a WordPress fordítórendszerével teheted meg.

LOCO Translate bővítménnyel​

  1. Telepítsd és aktiváld a LOCO Translate bővítményt a WordPress admin felületén.
  2. LOCO Translate menü → válaszd ki a HelloPack bővítményt a projektlistából, majd a nyelvet.
  3. Keresd meg a módosítandó szöveget, írd át a jobb oldali szerkesztő mezőben, majd Mentés.

Manuálisan, .po fájllal​

A wp-content/plugins/hellopack-client/languages mappából másold le a .po fájlt, módosítsd POEdit-tel, majd a fordítást másold a wp-content/languages/plugins/hellopack-client-hu_HU.po (magyar esetén) helyre.

Frissítés-biztos hely

A módosított fordítás csak akkor marad meg plugin frissítés után, ha a wp-content/languages/plugins mappában van. LOCO esetén az Áthelyezés fül (fordítási nézetben) ezt automatikusan elintézi.

A LOCO bővítményre csak a fordítás módosításának idejére van szükség — utána eltávolítható.