WPML kódolási API: shortcode-ok és konstansok

A WPML három eszközt ad a téma- és bővítményfejlesztőknek: hookokat (filterek és actionök), shortcode-okat és konstansokat. A shortcode-okat a tartalomban és PHP-kódban is használhatod (do_shortcode()).

Nyelvi konstansok

Konstans	Leírás	Példa
ICL_LANGUAGE_CODE	az aktuális nyelv kódja	fr
ICL_LANGUAGE_NAME	az aktuális nyelv neve az aktuális nyelven	Français
ICL_LANGUAGE_NAME_EN	az aktuális nyelv neve angolul	French

Ezek a konstansok elavultak, az aktuális nyelv lekérdezésére a wpml_current_language filter ajánlott.

A WPML CSS és JS fájljainak letiltása

A WPML saját CSS és JS fájlokat tölt be a navigáció és a nyelvváltó stílusához. Hogy melyik töltődik be, a választott nyelvváltótól függ. A fájlok a bővítmény templates/language-switchers/<választott nyelvváltó>/ mappájában vannak. Ha a témádban nincs rájuk szükség, ezekkel a konstansokkal tilthatod le őket:

Konstans	Milyen fájlt tilt le
ICL_DONT_LOAD_NAVIGATION_CSS	a navigáció stíluslapjait: cms-navigation-base.css, cms-navigation.css
ICL_DONT_LOAD_LANGUAGE_SELECTOR_CSS	a nyelvváltó style.css fájlját
ICL_DONT_LOAD_LANGUAGES_JS	a nyelvváltó script.js fájlját

A konstansokat a téma functions.php fájljában add meg:

define( 'ICL_DONT_LOAD_NAVIGATION_CSS', true );

Teszt- és fejlesztői oldalak: a fordítási szolgáltatással való kapcsolat letiltása

Fejlesztéskor gyakori, hogy az éles oldalt lemásolod egy teszt- vagy fejlesztői környezetbe. Ez a másolat alapból pontosan úgy kapcsolódik a fordítási szolgáltatáshoz, mint az éles oldal, ami zavart okozhat az éles oldal kommunikációjában. Példa:

1. A tesztoldal lehív egy kész fordítást a fordítási szolgáltatástól.
2. A szolgáltatás „kézbesítettnek” jelöli az elemeket.
3. Az éles oldalon már nem tudod lehívni ezeket a kézbesített fordításokat.

Ennek elkerülésére jelezd a WPML-nek, hogy a másolat csak tesztelésre szolgál. Add a következő sort a wp-config.php fájlhoz:

define( 'WPML_ENVIRONMENT', 'test' );

Ez csak a kritikus kéréseket tiltja le, a legtöbb kérés továbbra is működik. A fordítási szolgáltatások listája például a megszokott módon megjelenik.

WPML-shortcode-ok

wpml_language_selector_widget

• A WPML legördülő nyelvváltóját jeleníti meg.
• A wpml_add_language_selector hookhoz hasonló.
• A kimenetet a WPML → Settings → Language Switchers oldal Custom language switcher szakaszában testreszabhatod.

wpml_language_selector_footer

• A WPML vízszintes nyelvváltóját jeleníti meg.
• A kimenete megegyezik a wpml_footer_language_selector hookéval.
• A kimenetet a WPML → Settings → Language Switchers oldal Footer language switcher szakaszában testreszabhatod.

wpml_language_form_field

• Egyedi keresőűrlapot tesz többnyelvűvé. A kimenete megegyezik a wpml_add_language_form_field hookéval.

wpml-string

Sztringet regisztrál és fordít. A String Translation aktív kell hozzá.

[wpml-string context="my-domain" name="my-name"]My string[/wpml-string]

A sztring fordításához nyisd meg a WPML → String Translation oldalt, és keresd meg a saját neveiddel: Domain: my-domain, Name: my-name, String: My string. A sztring csak akkor regisztrálódik, ha előbb megnyitod a frontenden azt az oldalt, amelyen szerepel.

wpml_language_switcher

[wpml_language_switcher type="footer" flags=1 native=1 translated=1][/wpml_language_switcher]

Argumentum	Jelentés
type	a nyelvváltó típusa: footer, post_translations, widget vagy custom (alapértelmezett)
flags (alias: display_flags)	1: zászlók megjelenítése, 0: nem
link_current (alias: display_link_for_current_lang)	1: az aktuális nyelv is link, 0: nem
native (alias: display_names_in_native_lang)	1: nyelvnevek a saját nyelven, 0: nem
translated (alias: display_names_in_current_lang)	1: nyelvnevek az aktuális nyelven, 0: nem
template	a sablon slugja, ha felül kell írni; egyébként a típus határozza meg

A type paraméternél a WPML a WPML → Settings → Languages oldal beállításait használja, kivéve a widget típust, amely az alapértelmezett beállításokat veszi.

A WPML Multilingual CMS konstansai

Konstans	Mit csinál
ICL_DISABLE_CACHE	true esetén kikapcsolja a WPML objektum-gyorsítótárát. Alapértelmezett: false.
ICL_DONT_LOAD_LANGUAGES_JS	true esetén eltávolítja a nyelvváltó JavaScript-fájlját.
ICL_DONT_LOAD_LANGUAGE_SELECTOR_CSS	true esetén eltávolítja a nyelvváltó CSS-fájlját.
WPML_TRANSLATOR_CAN_USE_LS_SHORTCODE	true esetén a fordító fordítás közben használhatja a wpml_language_selector_widget shortcode-ot.
WPML_TRANSLATION_AUTO_UPDATE_ENABLED	Az oldalépítőknél a WPML magától frissíti a fordítást, ha az eredeti oldal változik. false értékkel kikapcsolhatod.
WPML_TAXONOMY_TRANSLATION_MAX_TERMS_RESULTS_SET	A WPML → Taxonomy translation oldalon megjelenő elemek száma. Alapértelmezett: 1000.
WPML_SAVE_XLIFF_PATH	A szerveren az a mappa, ahová a WPML → Translations oldalról letöltött XLIFF-fájlok másolata kerül.
WPML_DO_NOT_RESIZE_UPLOADED_FLAGS	A nyelvváltó zászlói alapból 18×12 pixelesre méreteződnek. true esetén ez kikapcsol, például ha saját CSS vagy JS kezeli a zászlókat, vagy animált GIF-et használsz.
WPML_INSTALLER_LOGGING	true esetén a WPML telepítőjének minden eseménye naplózódik az installer.log fájlba (a bővítmény vendor/otgs/installer/ mappájában). Csak fejlesztőknek való, az általános telepítői naplót a WPML → Support → Installer Support oldalon találod.
OTGS_DISABLE_AUTO_UPDATES	true esetén a WPML és a Toolset nem ellenőrzi automatikusan a frissítéseket, ezt kézzel kell megtenned.
WPML_EXPORT_ALL_TO_XLIFF_LIMIT	A WPML → Translations oldalról XLIFF-be exportálható feladatok legnagyobb száma. Alapértelmezett: 1700. Gyors szerveren növelheted.

Példa a WPML_SAVE_XLIFF_PATH használatára:

define( 'WPML_SAVE_XLIFF_PATH', '/home/test-user/Desktop' );

A WPML String Translation konstansai

Konstans	Mit csinál
WPML_ST_SYNC_TRANSLATION_FILES	true esetén több szerver között szinkronizálja a WPML fordítási fájljait (MO-fájlok).
WPML_ST_MO_SCANNING_LIMIT	Hány MO-fájlt importálhat a String Translation egyetlen kérésben. Alapértelmezett: 20000.

A WPML CMS Nav konstansai

Konstans	Mit csinál
WPML_CMS_NAV_DISABLE_CACHE	true esetén kikapcsolja a CMS Navigation gyorsítótárazását.
ICL_DONT_LOAD_NAVIGATION_CSS	true esetén nem tölti be a cms-navigation-base.css és a cms-navigation.css fájlt.

A CMS Navigationről a WPML CMS Navigation fejezetben olvashatsz.

A WPML Multilingual & Multicurrency for WooCommerce konstansa

A WCML_GEOLOCATED_COUNTRY konstanssal kényszerítheted, hogy a WooCommerce-kiegészítő egy adott országot használjon a földrajzi helymeghatározáskor. Az érték kétbetűs országkód, például GH Ghánához. Tesztelésre hasznos.

define( 'WCML_GEOLOCATED_COUNTRY', 'GH' );

Egyedi modulokhoz a wcml_geolocation_get_user_country hookot használd.