Hooks & Filters

Omnalingo exposes WordPress filters and actions for developers, all namespaced under omnalingo/…. Use them with add_filter() and add_action() as usual.

// Add a CSS selector to the translation exclusion list
add_filter('omnalingo/exclusions/selectors', function ($selectors) {
    $selectors[] = '.my-widget';
    return $selectors;
});

// Translate an HTML string on demand, using Omnalingo's engine
$german = apply_filters('omnalingo/translate/html', $html, 'de');

Note

Filters should return a value of the same type they receive (Omnalingo defensively coerces bad return types, but return the right one). Omnalingo registers no WP-CLI commands and no public REST endpoints — these hooks are the supported extension points.

Translation & rendering

Hook	Type	Signature	Purpose
omnalingo/translate/html	filter	($html, $langCode)	Translate a raw HTML string into a language with Omnalingo’s engine; returns the translated HTML.
omnalingo/render/set_target_language	action	($langCode)	Set the active render target language (null/'' clears it).
omnalingo/render/target_language	filter	(null)	Read the current render target language.
omnalingo/render/enable_gettext_wrapping	action	()	Enable gettext wrapping for the current render.
omnalingo/render/disable_gettext_wrapping	action	()	Disable gettext wrapping.
omnalingo/render/wrapping_enabled	filter	(false)	Read whether gettext wrapping is on.
omnalingo/gettext/skip_wrap	filter	(false)	Return true to skip wrapping gettext strings this request.
omnalingo/gettext/backtrace_unsafe	filter	($functions)	Adjust the list of calling functions for which gettext wrapping is skipped.
omnalingo/buffer/skip	filter	(false)	Return true to skip the output-buffer translation pass this request.

Note

The render/* and translate/html hooks are the low-level engine API — the same one the Pro email translator uses to render a message in a customer’s language.

Slugs & URLs

Hook	Type	Signature	Purpose
omnalingo/slug/translate_url	filter	($url, $langCode, $postId, $termId)	Return the translated-slug URL for an object in a language. The central slug hook.
omnalingo/slug/resolve_path	filter	($path, $langCode)	Map an incoming translated path back to its canonical path.
omnalingo/slug/translations	filter	([], $objectId, $objectType)	Per-language slug translations for one object.
omnalingo/slug/map	filter	([], $items)	Bulk slug map for a set of content items.
omnalingo/slug/batch_size	filter	(200)	Batch size for slug operations.
omnalingo/slug/original_changed	action	($id, $type, $newSlug)	An object’s original slug changed ($type = post or term).
omnalingo/slug/object_deleted	action	($id, $type)	An object was deleted.
omnalingo/editor/build_url	filter	($url, $targetUrl)	The URL used to load a page in the editor frame.
omnalingo/editor/language_urls	filter	($urls, $baseUrl)	Per-language URLs offered in the editor.
omnalingo/editor/title_translated	action	($contentId, $type)	A title was translated (e.g. to refresh its slug).

Sitemap & SEO

Hook	Type	Signature	Purpose
omnalingo/sitemap/enabled	filter	(true)	Enable or disable Omnalingo’s sitemap output.
omnalingo/sitemap/url	filter	('')	Provide the sitemap URL (used by SEO-plugin integrations).
omnalingo/sitemap/alternates	filter	([], $entryId, $objectType)	hreflang alternates for a sitemap entry.
omnalingo/sitemap/exclude_object	filter	(false, $objectId, $objectType)	Exclude an object from the sitemap.

Content & scanning

Hook	Type	Signature	Purpose
omnalingo/content_types	filter	([])	Register custom translatable content types (e.g. emails).
omnalingo/content_settings/presets	filter	($presets, $context)	Adjust the Sitemap content-type presets.
omnalingo/content_settings/default_selections	filter	($defaults)	Default selected content types.
omnalingo/content_settings/default_preset	filter	('wordpress_default')	The default content preset slug.
omnalingo/scan/translatable_meta_tags	filter	($metaTags)	Which meta tags are extracted for translation.
omnalingo/scan/url_scanned	action	($urlId)	Fired after a URL is scanned.
omnalingo/scan/gathering_complete	action	($trigger)	Fired when content gathering finishes.
omnalingo/exclusions/selectors	filter	($selectors)	The CSS-selector exclusion list.

Settings & admin

Hook	Type	Signature	Purpose
omnalingo/settings/tabs	filter	([])	Register extra settings tabs.
omnalingo/settings/groups	filter	($groups)	Per-tab settings group definitions.
omnalingo/admin/hydration_data	filter	($data)	The data object passed to the admin interface.

Database & lifecycle

Hook	Type	Signature	Purpose
omnalingo/db/table_prefix	filter	($prefix)	The table prefix for Omnalingo’s tables.
omnalingo/db/reset	action	()	Fired on factory reset.
omnalingo/client/refreshed	action	($clientData)	Fired when license/client data is refreshed.
omnalingo/fixture/captured	action	($name, $dir, $mode)	Fired when a support fixture is captured.
omnalingo/container	filter	(null)	Returns the plugin’s dependency-injection container — advanced; lets you reach internal services.

Pro hooks

These are added by the Omnalingo Pro plugin (on top of the shared hooks above, which Pro also uses):

Hook	Type	Signature	Purpose
omnalingo/email/providers	filter	([])	Register e-commerce email providers for translation.
omnalingo/email/preview_capability	filter	('edit_posts')	Capability required to use the email preview.
omnalingo/xliff/imported	action	($langCode, $languageData)	Fired after an XLIFF file is imported for a language.