Kuke za dodatke i teme

Dokumentacija / Razvojni programeri

Kuke koje SwiftLing nudi drugim dodacima i temama. SwiftLing Pro izgrađen je isključivo na njima: ne mijenja ništa u samom SwiftLingu.

SWIFTLING_HOOKS označava verziju ovog popisa. Broj verzije raste kada se doda ili promijeni kuka, pa dodatak može provjeriti ima li SwiftLing ono što mu je potrebno:

if ( ! defined( 'SWIFTLING_HOOKS' ) || SWIFTLING_HOOKS < 1 ) {
	return; // Too old a SwiftLing.
}

tests/HooksTest.php ne prolazi ako se u SwiftLing doda kuka koja ovdje nije opisana ili ako je ovdje opisana kuka koje nema u SwiftLingu.

Administratorski zasloni

swiftling_admin_screens

Filtar, od verzije kuka 1. SwiftLingovi administratorski zasloni, poredani redoslijedom u izborniku i indeksirani prema oznaci u svojoj adresi (admin.php?page=<slug>). Dodatak dodaje zaslon u izbornik ili u skupinu; pogledajte swiftling_admin_groups.

Key
menu	Name: the screen’s title, its menu item, and its name in the list of its group. Required.
view	A name for the screen, unique among the screens. Required.
file	Path of the PHP file that prints the screen. Without it, admin/views/<view>.php of SwiftLing.
group	A group of swiftling_admin_groups: the screen is out of the menu, unless it is the group’s first, and shows the group’s header and list.
part	The part of the group’s list the screen is listed in. Without it, the screen is in the group but not listed.
icon, tint	The screen’s picture in the list: the path of a 16 by 16 line drawing, on a tile of orange, blue, green, teal, amber, violet or ink.
hidden	Reachable only by link, never in the menu.
count	Since hooks 25: a number to show beside the screen’s menu item, as WordPress shows pending comments, such as replies waiting to be read. A screen of a group adds it to the group’s item; SwiftLing’s own item shows the sum of all, so it is seen with the menu closed. 0 shows nothing.
cap	Since hooks 12: the capability the screen takes; without it, manage_options. The Translations screens and the translation editor take swiftling_translate, see swiftling_can_translate. The menu and the list of a group show a user only the screens they may open.
before_setup	Since hooks 20: the screen opens before the first setup is answered, as an import that sets the languages up from another plugin’s (swiftling_import_languages()). Until then every other screen leads to the first setup.

Datoteka prikazuje zaslon unutar SwiftLingove stranice, uz njegove stilove. Počinje pozivom SwiftLing\Admin\Ui::screenHeader(), kao i SwiftLingovi prikazi. Zaslon bez naziva ili datoteke prikaza, kao i zaslon čija se datoteka ne može pročitati, izostavlja se; zaslon koji pripada skupini koje nema u SwiftLingu prikazuje se kao samostalan zaslon.

add_filter(
	'swiftling_admin_screens',
	static function ( array $screens ): array {
		$screens['swiftling-glossary'] = array(
			'menu'  => __( 'Glossary', 'my-plugin' ),
			'view'  => 'glossary',
			'file'  => __DIR__ . '/views/glossary.php',
			'group' => 'settings',
			'part'  => 'swiftling',
			'icon'  => 'M2 4h12M2 8h12M2 12h8',
			'tint'  => 'violet',
		);
		return $screens;
	}
);

swiftling_admin_groups

Filtar, od verzije kuka 1. Skupine zaslona, indeksirane prema ID-u: translations i settings. Skupina je jedna stavka izbornika pod svojim nazivom, koja otvara njezin prvi zaslon. Na svakom njezinu zaslonu prikazuju se zaglavlje skupine (name, description) i popis njezinih zaslona po odjeljcima (parts, nazivi indeksirani prema odjeljku). Dodatak može dodati skupinu ili odjeljke skupini.

add_filter(
	'swiftling_admin_groups',
	static function ( array $groups ): array {
		$groups['settings']['parts']['automatic'] = __( 'Automatic', 'my-plugin' );
		return $groups;
	}
);

swiftling_setup_offer

Akcija, od verzije kuka 24. Pokreće se iznad pitanja u prvom koraku postavljanja, u kojem se osobu koja upravlja web-mjestom pita na kojem je jeziku web-mjesto napisano. Drugi dodatak ondje može ponuditi način postavljanja SwiftLinga koji bolje odgovara web-mjestu, primjerice uvoz prijevoda iz prethodno korištenog višejezičnog dodatka koji nudi SwiftLing Pro, na zaslonu koji se otvara prije postavljanja (before_setup iznad). Ako nešto prikaže, to dolazi prvo i postaje glavni naslov stranice (<h1>); pitanje slijedi pod naslovom „ili postavite SwiftLing ručno”, njegov je naslov jednu razinu niži, a gumb sporedan. Ako ne prikaže ništa, postavljanje izgleda kao i bez njega.

add_action(
	'swiftling_setup_offer',
	static function (): void {
		if ( my_plugin_has_old_translations() ) {
			printf( '<section class="swiftling-card"><h1>%s</h1><p><a class="swiftling-button is-primary" href="%s">%s</a></p></section>', esc_html__( 'Bring your translations along', 'my-plugin' ), esc_url( admin_url( 'admin.php?page=my-import' ) ), esc_html__( 'Import', 'my-plugin' ) );
		}
	}
);

swiftling_setup_aside

Akcija, od verzije kuka 20. Pokreće se ispod prvog koraka postavljanja, u kojem se osobu koja upravlja web-mjestom pita na kojem je jeziku web-mjesto napisano. Drugi dodatak može ponuditi drukčiji način postavljanja jezika, na zaslonu koji se otvara prije postavljanja (before_setup iznad). Za ponudu koja se treba prikazati prva pogledajte swiftling_setup_offer.

add_action(
	'swiftling_setup_aside',
	static function (): void {
		printf( '<p><a href="%s">%s</a></p>', esc_url( admin_url( 'admin.php?page=my-import' ) ), esc_html__( 'Import from my old plugin', 'my-plugin' ) );
	}
);

swiftling_admin_screen_assets

Akcija, od verzije kuka 1. Pokreće se pri učitavanju skripti i stilova SwiftLingova zaslona, nakon učitavanja SwiftLingovih vlastitih datoteka. SwiftLingov stilski predložak učitava se na svakom njegovu zaslonu, uključujući zaslone drugih dodataka.

• string $slug: oznaka u adresi zaslona, npr. swiftling-languages.
• array $screen: zaslon kakav vraća swiftling_admin_screens.

add_action(
	'swiftling_admin_screen_assets',
	static function ( string $slug ): void {
		if ( 'swiftling-glossary' === $slug ) {
			wp_enqueue_script( 'my-glossary', plugins_url( 'glossary.js', __FILE__ ), array(), '1.0.0', true );
		}
	}
);

Prevođenje

swiftling_can_translate

Filtar, od verzije kuka 12. Određuje smije li prevoditi korisnik koji ne upravlja web-mjestom. Prevođenje zahtijeva ovlast swiftling_translate: imaju je svi s ovlasti manage_options te oni koje odredi ovaj filtar; ne računa se uloga kojoj je ta ovlast spremljena, primjerice putem uređivača uloga. SwiftLing Pro dodjeljuje je svojoj ulozi Prevoditelj i ulogama odabranima za nju.

Prevoditelj koji ne upravlja web-mjestom može otvoriti zaslone Prijevoda i uređivač prijevoda te prevoditi sve tekstove na svim jezicima, čak i ono što ne smije uređivati, poput predloška, obrasca ili tekstova teme (swiftling_is_translator()). Postavke ostaju u nadležnosti osobe koja upravlja web-mjestom: jezici, adrese, prebacivač jezika, usluga, opće postavke, zapisnici, Prevedi sve te odabiri na zaslonima Prijevoda koji su postavke, poput toga koja su polja pojmova tekstualna, na kojim se jezicima prikazuju stavke izbornika te pronalaženja tekstova tema i dodataka.

• bool $can: smije li korisnik prevoditi; false, osim ako neki drugi dodatak ne odredi drukčije.
• WP_User $user: korisnik.

swiftling_translator_machine

Filtar, od verzije hooks 13. Određuje smije li prevoditelj koji ne upravlja web-mjestom prevoditi pomoću njegove usluge strojnog prevođenja, čiji trošak snosi osoba koja upravlja web-mjestom (swiftling_can_machine_translate()). Ako mu to nije dopušteno, zahtjev za strojno prevođenje vraća 403, a uređivač prijevoda ne nudi strojno prevođenje, kao da usluga nije dostupna. Osoba koja upravlja web-mjestom uvijek ga smije koristiti. SwiftLing Pro provjerava ovu postavku u Postavke › Prevoditelji.

• bool $can: true, osim ako neki dodatak ne odredi drukčije.
• WP_User $user: prevoditelj.

swiftling_translation_services

Filtar. Usluge strojnog prevođenja, indeksirane po ID-u. Dodatak može dodati vlastitu uslugu, podklasu SwiftLing\Translation\Service; ona se prikazuje uz ostale na zaslonu usluga prevođenja.

• array<string, Service> $services

Usluga nasljeđuje SwiftLing\Translation\Service, kao što to čini SwiftLing\Translation\Google:

Method
id(), name(), fullName()	deepl; DeepL, as in “Translate with DeepL”; DeepL API. The ID names its settings and the constant that can hold its key, SWIFTLING_DEEPL_API_KEY.
check( $key )	Checks a key with the service: array( 'languages' => codes ), or a WP_Error whose message says what to do. Since hooks 5, a service with models to choose from adds 'models' => array( ID => name ), the models the key may use. Since hooks 6, an error whose data has 'reason' => 'billing' is a key that works on an account that cannot pay (no credits, billing off, a spend limit reached): the screen says so as a warning, and the service does not translate until a check passes.
languageCode( $language )	The service’s code for a language of swiftling_languages(), or null when it does not translate it.
translate( $items, $source, $target )	Translates texts: see the method’s description. Since hooks 5, a language model adds tokens to its answer, the tokens it read and wrote, counted by month beside the characters (Services::tokens()).
freeCharacters(), pricingUrl()	Optional: characters translated free of charge each month, and the address of its prices.
quota()	Optional, since hooks 4: the usage of the billing period as the service counts it, array( 'used' => …, 'limit' => … ) (0 for a plan without a limit). The screen shows it instead of freeCharacters().
guide()	Optional, since hooks 2: how to get a key, shown on the Translation service screen while the service is not connected.
defaultModel()	Optional, since hooks 5: the model the service translates with until another is chosen. The Translation service screen offers the models of the last check in a list; model() gives the one chosen, the default, or the first.
sourceLanguage(), targetLanguage()	Since hooks 9: the languages of the translation under way, as swiftling_languages() gives them, told by setLanguages() before every translate(). A service heeds more than its codes with them: the formal variant of a locale (de_DE_formal is DE to DeepL), or what is set for the language.
kind()	Optional, since hooks 3: machine (the default), a translation engine billed per character, or ai, a language model billed per token. The Translation service screen lists services in a card per kind, each with SwiftLing’s icon of its kind, never a logo of the service.

Ključevi upisani na zaslonu usluga prevođenja zadržavaju slova, znamenke te znakove -, _, : i .. Ako je povezano više usluga, prevodi ona odabrana na tom zaslonu (Services::current(), od verzije hooks 2).

SwiftLing\Translation\Markup (od verzije hooks 2) za svaku uslugu radi ono što je Googleu potrebno pri radu s HTML-om: protect() i restore() čuvaju atribute oznaka na web-mjestu, keep() i unkeep() čuvaju rezervirana mjesta, varijable SEO dodataka (swiftling_seo_variables()) i riječi koje se nikad ne prevode unutar <span translate="no">, a plainToHtml() i htmlToPlain() prenose običan tekst kao HTML.

swiftling_translation_service

Filtar. Usluga koja prevodi stranicu, predložak ili popis pojmova na određeni jezik, kako bi dodatak mogao upotrebljavati različite usluge za različite jezike ili stranice.

• Service|null $service: povezana usluga ili null ako nijedna nije povezana.
• string $subject: ključ onoga što se prevodi, npr. post:12.
• array $language: jezik, u obliku koji vraća swiftling_languages().

Provjera stranice na poslužitelju

Od verzije hooks 14, swiftling_server_check( $key, $user_id = null ) provjerava stranicu sadržaja koji se prevodi (post:12, template:…, terms:category; pogledajte swiftling_subject()) na poslužitelju, kao što je uređivač prijevoda provjerava u pregledniku, te pohranjuje rezultate. To omogućuje prevođenje bez preglednika, u pozadini, pri objavljivanju, putem REST API-ja ili WP-CLI-ja. Web-mjesto samo sebi šalje zahtjeve za obje stranice provjere putem povratne veze, kao što to radi Site Health, uz potpisani token koji vrijedi nekoliko minuta za taj sadržaj i stranicu, prikazanu za zadanog korisnika (prema zadanim postavkama trenutačnog korisnika), koji mora imati pravo prevoditi taj sadržaj. Vraća pohranjene rezultate ili WP_Error. Skripte se ne izvršavaju: tekst koji skripta stvori nakon učitavanja stranice otkriva se samo provjerom u pregledniku.

Prevođenje bez uređivača

Od verzije hooks 15, includes/api.php izvršava korake uređivača prijevoda i postupka „Prevedi sve” na poslužitelju, u ime trenutačnog korisnika, uz ista prava i provjere; rute samog uređivača pozivaju iste funkcije. Svaka funkcija vraća WP_Error (sa status za REST odgovor) ako sadržaj koji se prevodi, jezik ili korisnička prava ne zadovoljavaju uvjete.

Function
swiftling_subject_texts( $key, $lang )	The texts of a subject (post:12, template:…, view:…, terms:category, menu:3, a builder’s subject) the user may translate, with their translations into a language: key, object, path, section, kind, type (text, html, code, url, or format for a text from code), original, translation, state (reviewed, machine, official, outdated, missing), previous and follows. The originals are never stored, so the page is checked on the server first (swiftling_server_check()).
swiftling_save_texts( $key, $lang, $items, $state )	Saves translations by key, as the editor saves what is typed: $items is a list of key, text and, for the check of placeholders, original; $state is reviewed or machine. An empty text removes a translation. Returns the states of what was saved, the keys refused for their placeholders and those ignored, the subject’s state in every language (languages), and a post’s address in the language.
swiftling_save_earlier_texts( $key, $lang, $items )	Since hooks 22, for an import: saves translations made for an earlier version of their originals, as another plugin kept them ($items: key of the text’s place now, text, and the earlier original it translated). Each text is outdated then, as when its original changed after it was translated here: visitors read the original, the editor shows the earlier translation, Translate everything leaves it to the editor, and the page counts as translated once its other texts are. A text translated now, one whose earlier version is the text now, and one another language waits with in another earlier version (a text has one previous version for all languages) are ignored; returns the keys saved too. The subject’s page must have been checked.
swiftling_save_address( $owner, $lang, $slug )	Saves the slug of a post (post:12) or of a term with a page of its own (term:5) in a language, as the editor saves a typed one: empty for the original slug, a number added to one taken there. Returns the address it gives: slug, state, original, prefix, url.
swiftling_machine_translate( $key, $lang, $items )	Translates texts (key, text, html) with the subject’s translation service, through swiftling_machine_items and swiftling_machine_translations, at most 100 texts and 20,000 characters at once; it does not save them. Returns translations, failed, kept and error.
swiftling_machine_translate_subject( $key, $lang, $again = array() )	Fills the empty texts of a subject with the service and saves them as machine translations, in batches of 50 texts and 4,000 characters, as the Translate everything run fills a page; with states in $again (machine, reviewed), translates the texts in those states again instead. Returns how many texts there were, how many were translated, their characters, the keys failed and refused, the service’s error if it stopped, and own_page when the language shows a separate copy of the post or keeps its original (the stored mode duplicate), where nothing is filled in.

Od hooks 19, swiftling_import_languages( $source, $targets, $address ) postavlja jezike web-mjesta prema jezicima drugog dodatka pri uvozu: izvorni jezik (locale, slug) kako je postavljen pri prvom podešavanju ili isti onaj koji već ima SwiftLing (inače swiftling_import_source); ciljni jezici (locale, slug, visible te name i rtl za lokalizaciju koju WordPress ne navodi, a koja postaje prilagođeni jezik) dodaju se prema lokalizaciji, dok se postojeći jezici web-mjesta zadržavaju; te $address: format (parameter, directory; domain i subdomain zadržavaju svoje domains, ali čekaju zaslon Adrese) i source_folder. Funkcija vraća dodane (added) i zadržane (kept) lokalizacije, slugs, podatak o tome čeka li format na hosts te instalirane i nedostajuće prijevode WordPressa (packs). Od hooks 20 pokreće se i putem REST API-ja, WP-CLI-ja i WP-Crona, a ne samo na administratorskim zaslonima. Od hooks 21, name zadan za lokalizaciju koju WordPress drukčije naziva, primjerice “English” za en_GB (“English (UK)”), postaje naziv koji se za nju prikazuje u biraču jezika i njezina oznaka na zaslonu Jezici.

Komentari i tekstovi teme ili dodatka popisi su koji se na pripadajućim zaslonima prikazuju po stranicama: njihovi se tekstovi spremaju i prevode prema ključu, ali se ovdje ne prikazuju niti popunjavaju. Od hooks 23, swiftling_subject_found( $subject, array( 'page' => 1 ) ) vraća jednu stranicu popisa komentara (comments:<post type>) onako kako ih prikazuje uređivač komentara: sve komentare, od najnovijeg, uz list (njegove page i pages; lang označava jezik za koji vrijede navedeni brojevi), kako bi se njihovi prijevodi mogli spremiti prema ključu pomoću swiftling_save_texts().

swiftling_machine_items

Filtar, od hooks 9. Tekstovi iz uređivača koji se šalju prevoditeljskoj usluzi, kako bi im dodatak mogao nešto pridodati: dijelove koje treba sačuvati (keep), primjerice riječi određene glosarom za uslugu koja ne podržava glosar, ili ključeve koje čita vlastita usluga dodatka. SwiftLing zadržava tekstove, podatak o tome jesu li HTML i vlastite dijelove koje treba sačuvati u izvornom obliku te šalje samo tekstove stranice.

• array<string, array> $items: ključ => text, html, keep; pogledajte Service::translate().
• Service $service: usluga koja ih prevodi.
• array $language: jezik na koji se prevode, u obliku koji vraća swiftling_languages().

swiftling_machine_translations

Filtar, od hooks 9. Prijevodi koje je usluga vratila, prije nego što SwiftLing provjeri njihove rezervirane oznake i varijable SEO dodataka te ih uređivač umetne, kako bi ih dodatak mogao izmijeniti, primjerice umetanjem riječi određenih glosarom na mjesta na kojima su bile sačuvane. Samo prevedeni tekstovi, svaki i dalje kao tekst.

• array<string, string> $translations: ključ => prijevod.
• array<string, array> $items: ono što je poslano; pogledajte swiftling_machine_items.
• Service $service
• array $language

swiftling_translated_changed

Akcija. Pokreće se nakon što se ponovno zapišu jezici na koje su prevedene neke objave.

• int[] $post_ids

swiftling_translate_all_modes

Filtar, od verzije hooks 7. Načini rada zaslona Prevedi sve, označeni ključem načina rada i prikazani kao kartice: fill, SwiftLingov vlastiti način, popunjava prazne tekstove. Dodatak dodaje način rada s label (naziv kartice), description (redak ispod naslova zaslona), hint (opis onoga što radi na kartici), icon i tint (njegov prikaz, kao za zaslone u swiftling_admin_screens) te file (PHP datoteka koja prikazuje njegov zaslon ispod kartica, na adresi admin.php?page=swiftling-translate-all&mode=<mode>). Bez dodataka SwiftLing ima samo jedan način rada i ne prikazuje kartice. Njegove se skripte učitavaju putem swiftling_admin_screen_assets na swiftling-translate-all; ondje su i provjera stranice (window.swiftlingPageCheck) te zajednički modul za strojno prevođenje (window.swiftlingMachine).

Pokretanje koje ponovno prevodi tekstove šalje zahtjev ruti za provjeru, uz fill i again: machine, reviewed ili oboje. Ruta tada vraća tekstove prevedene u tim stanjima, svaki sa svojim state, umjesto praznih tekstova; nikad ne vraća tekst iz WordPressa, teme ili dodatka ni tekst čiji se izvornik promijenio. swiftling_translate_all_scan() broji ih po stranici i jeziku u translated (machine, reviewed; null za stranicu koja nikad nije provjerena).

swiftling_translate_all_aside

Akcija, od verzije hooks 17. Pokreće se na vrhu bočnog stupca zaslona Prevedi sve, iznad odjeljka Kako funkcionira, nakon povezivanja usluge prevođenja. Tu dodatak može prikazati vlastitu karticu o prevođenju cijele web-lokacije (s <section class="swiftling-card swiftling-side">), primjerice SwiftLing Pro karticu o prevođenju stranica čim se objave. U verziji hooks 16 umjesto toga postojao je swiftling_translate_all_notices ispod naslova zaslona; više ga nema.

swiftling_translate_all_start_actions

Akcija, od verzije hooks 18. Pokreće se u koraku Pokreni na zaslonu Prevedi sve, pokraj gumba kojim se pokreće prevođenje na kartici. Tu dodatak može dodati način pokretanja, primjerice SwiftLing Pro na poslužitelju.

• string $lang: jezik koji koraci prikazuju prvi ili "" kada nijedan nije dostupan.

Pokretanje kojim upravlja poslužitelj

Od verzije hooks 18, swiftling_translate_all_record( $lang, $args ) bilježi što je pokretanje funkcije Prevedi sve učinilo sa stranicom ili da je prevođenje na određeni jezik završeno, kao što to za pokretanje u pregledniku čini ruta napretka, te vraća stanje pokretanja (swiftling_translate_all_state()). $args: page (post:12), outcome (done ili skipped), reason, texts, characters, total, finish, stopped i driver (browser ili server). Dodatak koji upravlja pokretanjem na poslužitelju planira ga pomoću swiftling_translate_all_plan( $lang ), prevodi svaku stranicu pomoću swiftling_machine_translate_subject() i bilježi je uz driver postavljen na server.

Istodobno se obrađuje jedan jezik: onaj tko bilježi pokretanje upravlja njime dok se ne zaustavi (stopped), ne završi ili nema napretka tri minute (preglednik), odnosno pet minuta (poslužitelj). Drugom se za to vrijeme zahtjev odbija uz swiftling_translate_all_busy (409). Polje driver u stanju pokazuje tko trenutačno upravlja pokretanjem, a pločica jezika kojim upravlja poslužitelj na zaslonu to naznačuje i ne može se odabrati.

swiftling_editor_actions

Akcija, od verzije hooks 7. Pokreće se u zaglavlju uređivača prijevoda, nakon alata koji popunjavaju prazna polja, kako bi dodatak mogao prikazati vlastite alate.

• array $subject: ono što se prevodi; pogledajte swiftling_subject().
• array $language: prikazani jezik, u obliku koji vraća swiftling_languages().
• Service|null $service: usluga koja ga prevodi ili null.

Njegova skripta, učitana putem swiftling_admin_screen_assets na swiftling-translation nakon swiftling-editor, radi s poljima putem window.swiftlingEditor, nakon što ready postane true ili se događaj swiftling:editor-ready pokrene na document:

texts( states )	The text fields translated in those states (machine, reviewed): key, state, characters of the original. Never one from WordPress, a theme or a plugin, one whose original changed, or one with changes not saved.
translateAgain( states )	Translates those fields again with the service in use and saves them as machine translations, as “Translate empty fields” does: a promise of translated, failed and stopped (why the service stopped, or empty).
service	The name of the service in use, or empty.
dirty()	How many fields have changes not saved.

Jezici

Od verzije 10 sustava kuka, swiftling_switch_translation( $slug ) privremeno prebacuje prijevod na određeni jezik izvan stranice koju čitatelj pregledava, primjerice za e-poruku kupcu napisanu u administraciji ili stvorenu zakazanim zadatkom: pohranjene vrijednosti, tekstovi iz koda i poveznice čitaju se na tom jeziku, a WordPress radi na njegovoj lokalizaciji, sve do poziva swiftling_resume_translation(). swiftling_pause_translation() čini isto za izvorni jezik. Pozivi se mogu ugnijezditi; svaki zahtijeva odgovarajući poziv za nastavak. Ako slug nije jedan od jezika web-mjesta, koristi se izvorni jezik. SwiftLing Pro na taj način piše WooCommerceove e-poruke kupcu na jeziku narudžbe.

swiftling_language_forgotten

Akcija. Pokreće se nakon što se na zaslonu Jezici izbriše ono što je bilo pohranjeno za jezik koji više nije na web-mjestu, kako bi dodatak mogao izbrisati i ono što sam pohranjuje za taj jezik.

• string $locale: oznaka lokalizacije jezika.
• array $done: ono što je izbrisano, texts i copies.

swiftling_starting_over

Akcija, od verzije 11 sustava kuka. Pokreće se kad se SwiftLing počne vraćati na početno stanje putem Postavke › Općenito, prije nego što išta ukloni, kako bi dodatak izgrađen na njemu mogao ukloniti ono što pohranjuje dok još može koristiti podatke koje će SwiftLing zatim ukloniti, poput ključa usluge za prevođenje. Uz everything, SwiftLing zatim uklanja sve opcije i privremene podatke koji nose njegov naziv, uključujući swiftling_, pa i one koji pripadaju dodatku koji ga sadrži u nazivu, kao što je SwiftLing Pro. Brisanjem SwiftLinga ništa se ne uklanja: vraćanje na početno stanje jedini je način uklanjanja njegovih podataka.

• string $scope: everything ili keep kada se prijevodi zadržavaju.

swiftling_started_over

Akcija. Pokreće se nakon što se SwiftLing vrati na početno stanje putem Postavke › Općenito.

• string $scope: everything ili keep kada su prijevodi zadržani.

swiftling_start_over_removed

Filtar, od verzije 11 sustava kuka. Dodaje retke na popis onoga što se uklanja vraćanjem na početno stanje na stranici Postavke › Općenito, kako bi korisnik ondje mogao vidjeti i što uklanja dodatak izgrađen na SwiftLingu.

• string[] $removed: retci u običnom tekstu.

swiftling_language_switcher

Akcija za teme. Prikazuje izbornik jezika; ne prikazuje ništa kada SwiftLing nije aktivan.

• array $args: neobavezno, isti argumenti koje prima swiftling_language_switcher(): style (dropdown, horizontal, vertical), flag, name, code, current, class.

<?php do_action( 'swiftling_language_switcher', array( 'style' => 'horizontal' ) ); ?>

swiftling_switcher_html

Filtar, od verzije 8 sustava kuka. HTML izbornika jezika na svakom mjestu gdje se prikazuje (izbornik, podnožje, blok, kratki kod, widget, swiftling_language_switcher), kako bi mu dodatak mogao nešto dodati. SwiftLing Pro uz njega dodaje svoj izbornik valuta. Ne poziva se kada nema drugog jezika na koji se može prebaciti.

• string $html: izbornik jezika, element div.swiftling-switcher.
• array $args: njegove opcije: style (dropdown, horizontal, vertical), flag, name, code, current, class, flag_size.

Stranice

swiftling_hreflangs

Filtar. Alternativne adrese prikazane stranice, ispisane kao poveznice hreflang.

• array<string, string> $links: oznaka jezika ili x-default => adresa.
• array $page: adresa stranice na izvornom jeziku bez oznake jezika (url), objava čiji prijevodi određuju dostupne jezike stranice (post, 0 za naslovnu stranicu objava i arhive) te ono od čega se sastavlja njezina adresa (build).

swiftling_search_limit

Filtar. Najveći broj objava koje jedno pretraživanje uzima iz indeksa prijevoda.

• int $limit
• WP_Query $query

Predmemorije

swiftling_purge_all

Akcija. Pokreće se jednom na kraju zahtjeva nakon kojeg svaka stranica može biti zastarjela, kako bi predmemorije stranica ispraznile sav sadržaj.

swiftling_purge_urls

Akcija. Pokreće se jednom na kraju zahtjeva nakon kojeg su neke stranice zastarjele, kako bi ih predmemorije stranica uklonile.

• string[] $urls: adrese na svim jezicima na kojima su zastarjele.
• int[] $post_ids: objave kojima adrese pripadaju, za predmemorije koje se prazne prema objavi.

Zapisnici i podrška

swiftling_log_areas

Filtar. Područja na zaslonu Zapisnici, pri čemu su ključevi područja, a vrijednosti njihovi nazivi, kako bi dodatak mogao imenovati vlastito područje i pisati u isti zapisnik pomoću swiftling_log( $level, $area, $message, $args ).

• array<string, string> $areas

swiftling_request_url

Filtar. Adresa na koju se šalju zahtjevi za podršku za dodatak, temu ili obrazac; pogledajte includes/requests.php.

• string $url