---
title: Hooks Reference
description: Every action and filter ShapeTranslate fires. filter changes a value; action runs your code at that moment.
url: "https://shapetranslate.com/docs/dev-hooks/"
updated: "2026-11-16"
category: Developer Guide
---

# Hooks Reference

Every action and filter ShapeTranslate fires. filter changes a value; action runs your code at that moment.

## Common recipes

Make a custom post type translatable

```
add_filter( 'shapetranslate_supported_post_types', function ( $post_types ) {
    $post_types[] = 'portfolio';
    return array_unique( $post_types );
} );
```

Copy a protected meta key into new translations

```
add_filter( 'shapetranslate_copy_post_meta_keys', function ( $keys, $sync ) {
    $keys[] = '_my_price_note';
    return $keys;
}, 10, 2 );
```

Run code when a translation is created

```
add_action( 'shapetranslate_translation_created', function ( $new_post_id, $source_id, $language ) {
    update_post_meta( $new_post_id, '_needs_proofreading', 1 );
    // $language is the language record: $language['url_slug'], $language['locale'] …
}, 10, 3 );
```

Keep the language cookie for 30 days instead of a year

```
add_filter( 'shapetranslate_language_cookie_lifetime', function () {
    return 30 * DAY_IN_SECONDS;
} );
```

Skip browser detection for bots

```
add_filter( 'shapetranslate_should_detect_language', function ( $allowed ) {
    $ua = isset( $_SERVER['HTTP_USER_AGENT'] ) ? (string) $_SERVER['HTTP_USER_AGENT'] : '';
    return $allowed && ! preg_match( '/bot|crawl|spider/i', $ua );
} );
```

## All hooks

253 hooks, grouped by area. Use the docs search, or your browser's find (Ctrl + F), to look one up.

### Bootstrap & lifecycle 12

| Hook | Type | Arguments | When / what |
| --- | --- | --- | --- |
| `shapetranslate_loaded` | action | `Plugin $plugin` | All services and modules are ready. Safe point to use the API. |
| `shapetranslate_modules` | filter | `array $modules, Plugin $plugin` | Add or remove modules before they register. |
| `shapetranslate_activated` | action | — | End of plugin activation. |
| `shapetranslate_deactivated` | action | — | Plugin deactivated. |
| `shapetranslate_before_upgrade` | action | `string $installed, string $target` | Before a database schema upgrade. |
| `shapetranslate_upgraded` | action | `string $installed, string $target` | After a schema upgrade. |
| `shapetranslate_setup_completed` | action | — | Setup Wizard finished. |
| `shapetranslate_language_repository` | filter | `LanguageRepositoryInterface $repo` | Replace where languages are stored. |
| `shapetranslate_string_repository` | filter | `StringRepositoryInterface $repo` | Replace the string storage. |
| `shapetranslate_translation_repository` | filter | `TranslationRepositoryInterface $repo` | Replace post relationship storage. |
| `shapetranslate_term_translation_repository` | filter | `TermTranslationRepositoryInterface $repo` | Replace term relationship storage. |
| `shapetranslate_translation_dashboard_repository` | filter | `?Interface $repo, $translation_repo` | Return null to turn off the dashboard. |

### Languages 20

| Hook | Type | Arguments | When / what |
| --- | --- | --- | --- |
| `shapetranslate_registered_languages` | filter | `array $languages` | Languages after loading from storage. |
| `shapetranslate_language_registered` | action | `array $language` | A language was added. |
| `shapetranslate_language_updated` | action | `array $language, array $previous` | A language was edited or enabled/disabled. |
| `shapetranslate_pre_delete_language` | filter | `true|WP_Error $can, string $id, array $language` | Return a WP_Error to block deletion. |
| `shapetranslate_language_deleted` | action | `string $id, array $language` | A language was deleted. |
| `shapetranslate_language_order_changed` | action | `array $languages` | Languages were reordered. |
| `shapetranslate_default_language_id` | filter | `string $id` | ID of the default language. |
| `shapetranslate_default_language` | filter | `?array $language` | The default language record. |
| `shapetranslate_default_language_changed` | action | `string $new, string $old` | The default language changed. |
| `shapetranslate_pre_validate_language` | filter | `array $input, string $id` | Raw form input before validation. |
| `shapetranslate_current_language_id` | filter | `string $default, array $languages` | Choose the current language ID. |
| `shapetranslate_current_language` | filter | `?array $current, array $languages` | The resolved current language. |
| `shapetranslate_language_catalog` | filter | `array $catalog` | Presets in the "Choose a language" list. |
| `shapetranslate_language_tag` | filter | `string $tag, array $language` | BCP-47 tag used in the HTML lang attribute. |
| `shapetranslate_request_locale` | filter | `string $resolved, string $locale` | Locale for a front-end request. Return '' to keep WordPress's. |
| `shapetranslate_should_switch_locale` | filter | `bool $allowed` | Allow switching the WordPress locale. |
| `shapetranslate_flag_code` | filter | `string $code, $language` | Flag code for a language. |
| `shapetranslate_flag` | filter | `array $flag, $language` | Flag information. |
| `shapetranslate_flag_html` | filter | `string $html, array $flag, $language` | Flag markup. |
| `shapetranslate_custom_flag_url` | filter | `string $url, string $locale` | Use your own flag image. |

### Posts & translations 21

| Hook | Type | Arguments | When / what |
| --- | --- | --- | --- |
| `shapetranslate_supported_post_types` | filter | `array $post_types, array $objects` | Translatable post types. |
| `shapetranslate_non_public_post_types` | filter | `array $types` | Non-public types that may be translated (default wp_block). |
| `shapetranslate_post_language` | filter | `?array $language, int $post_id` | Language of a post. |
| `shapetranslate_post_translations` | filter | `array $map, int $post_id, string $group` | A post's translation group. |
| `shapetranslate_post_language_changed` | action | `int $post_id, string $lang, string $old, string $group` | A post moved to another language. |
| `shapetranslate_translations_linked` | action | `string $group, array $map, int $source_id` | Posts were linked as a group. |
| `shapetranslate_translation_copy_post_data` | filter | `array $post_data, WP_Post $source, array $language` | Fields of a new translated draft. |
| `shapetranslate_insert_translation` | filter | `?int $new_id, array $data, WP_Post $source, array $language` | Create the translation yourself; null keeps the default. |
| `shapetranslate_translation_featured_image_id` | filter | `int $thumb_id, array $language, int $new_id, int $source_id` | Featured image of a new translation. |
| `shapetranslate_translation_featured_image_copied` | action | `int $new_id, int $source_id, int $thumb_id` | Featured image was reused. |
| `shapetranslate_translation_created` | action | `int $new_id, int $source_id, array $language, string $group, array $copy_options` | A translated draft was created and linked. |
| `shapetranslate_post_translation_unlinked` | action | `int $post_id, array $previous` | A post left its group. |
| `shapetranslate_translation_group_deleted` | action | `string $group` | An empty group was removed. |
| `shapetranslate_auto_assign_default_post_language` | filter | `bool $assign, int $post_id, WP_Post $post` | Give new posts the default language on save. |
| `shapetranslate_new_post_language_id` | filter | `string $lang, WP_Post $post` | Starting language of a new post. |
| `shapetranslate_translation_post_trashed` | action | `int $post_id, string $previous_status` | A translation was trashed. |
| `shapetranslate_translation_post_untrashed` | action | `int $post_id, string $previous_status` | A translation was restored. |
| `shapetranslate_translate_query_ids` | filter | `bool $on, WP_Query $query` | Translate IDs in post__in and similar. |
| `shapetranslate_translate_term_query_ids` | filter | `bool $on, array $args` | Same for term queries. |
| `shapetranslate_adjacent_post_language` | filter | `string $lang, WP_Post $post` | Language for previous/next links; '' = all. |
| `shapetranslate_filter_comments_by_language` | filter | `bool $on, WP_Comment_Query $q, array $language` | Show only comments in the page's language. |

### Terms & taxonomies 16

| Hook | Type | Arguments | When / what |
| --- | --- | --- | --- |
| `shapetranslate_supported_taxonomies` | filter | `array $taxonomies, array $objects` | Translatable taxonomies. |
| `shapetranslate_term_language` | filter | `?array $language, int $term_id, string $tax` | Language of a term. |
| `shapetranslate_term_translations` | filter | `array $map, int $term_id, string $tax, string $group` | A term's group. |
| `shapetranslate_term_language_changed` | action | `int $term_id, string $tax, string $lang, string $old, string $group` | A term moved language. |
| `shapetranslate_term_translations_linked` | action | `string $group, array $map, int $source_id, string $tax` | Terms were linked. |
| `shapetranslate_term_translation_group_deleted` | action | `string $group, string $tax` | A term group was removed. |
| `shapetranslate_term_translation_copy_data` | filter | `array $data, WP_Term $source, array $language` | Fields of a new translated term. |
| `shapetranslate_term_translation_created` | action | `int $new_id, int $source_id, string $tax, array $language, string $group` | A translated term was created. |
| `shapetranslate_term_translation_unlinked` | action | `int $term_id, string $tax, array $previous` | A deleted term left its group. |
| `shapetranslate_auto_assign_default_term_language` | filter | `bool $assign, int $term_id, string $tax` | Give new terms the default language. |
| `shapetranslate_new_term_language_id` | filter | `string $lang, string $tax` | Starting language of a new term. |
| `shapetranslate_default_term_id` | filter | `int $term_id, string $tax, string $lang, int $stored` | Default term per language. |
| `shapetranslate_default_term_language_id` | filter | `string $lang, string $tax` | Language a default term resolves for. |
| `shapetranslate_realign_default_term` | filter | `bool $on, int $post_id, string $tax, string $lang` | Move a lone default term into the post's language. |
| `shapetranslate_seed_default_term` | filter | `bool $on, int $stored, string $tax, string $lang` | Auto-translate the default term for a new language. |
| `shapetranslate_mapped_term_id` | filter | `int $translation, int $term_id, string $tax, string $lang` | Term used on a translation during copy/sync (0 drops it). |

### Copy, sync & settings 15

| Hook | Type | Arguments | When / what |
| --- | --- | --- | --- |
| `shapetranslate_translation_items_copied` | action | `int $target, int $source, string $lang, array $options` | After the first copy into a translation. |
| `shapetranslate_translation_items_synchronized` | action | `int $target, int $source, string $lang` | After a sync into one translation. |
| `shapetranslate_current_user_can_synchronize` | filter | `bool $allowed, int $post_id` | Whether the user may sync. |
| `shapetranslate_copy_post_meta_keys` | filter | `string[] $keys, bool $sync, int $source, int $target, string $lang` | Meta keys copied or synced. |
| `shapetranslate_translate_post_meta_value` | filter | `mixed $value, string $key, string $lang, int $source, int $target` | Meta value written to the translation. |
| `shapetranslate_translation_copy_options` | filter | `array $options, WP_Post $source, array $language` | What a new translation copies. |
| `shapetranslate_workflow_settings` | filter | `array $settings` | Synchronization settings. |
| `shapetranslate_sync_catalog` | filter | `array $items` | Items on the Synchronization tab (add your own). |
| `shapetranslate_sync_catalog_labels` | filter | `array $labels` | Labels for those items. |
| `shapetranslate_settings` | filter | `array $settings` | The whole configuration. |
| `shapetranslate_settings_defaults` | filter | `array $defaults` | Default settings. |
| `shapetranslate_settings_updated` | action | `array $settings` | Settings were saved. |
| `shapetranslate_settings_export` | filter | `array $document` | Exported JSON. |
| `shapetranslate_validated_settings_import` | filter | `array|WP_Error $validated, array $document` | Return a WP_Error to stop an import. |
| `shapetranslate_settings_imported` | action | `array $result, array $validated` | After an import. |

### Admin screens 19

| Hook | Type | Arguments | When / what |
| --- | --- | --- | --- |
| `shapetranslate_manage_languages_capability` | filter | `string $cap` | Capability for ShapeTranslate screens and REST (default manage_options). |
| `shapetranslate_enable_admin_language_filter` | filter | `bool $on` | Show the admin-bar language filter. |
| `shapetranslate_hide_foreign_admin_notices` | filter | `bool $hide, string $page` | Hide other plugins' notices on ShapeTranslate screens. |
| `shapetranslate_translation_dashboard_bulk_actions` | filter | `array $actions, array $query_args` | Register dashboard bulk actions. |
| `shapetranslate_translation_dashboard_bulk_action` | action | `string $action, int[] $post_ids, array $query_args` | Handle your bulk action. |
| `shapetranslate_translation_dashboard_content_html` | filter | `string $html, array $item, WP_Post $post` | Content cell markup. |
| `shapetranslate_translation_dashboard_cell_html` | filter | `string $html, array $item, array $language, ?WP_Post $target, string $column` | Language cell markup. |
| `shapetranslate_translation_dashboard_before_table` | action | `$table` | Before the dashboard table. |
| `shapetranslate_translation_dashboard_after_table` | action | `$table` | After the dashboard table. |
| `shapetranslate_translation_dashboard_post_types` | filter | `array $types` | Post types on the dashboard. |
| `shapetranslate_translation_dashboard_languages` | filter | `array $languages` | Language columns. |
| `shapetranslate_translation_dashboard_query_args` | filter | `array $args` | Dashboard query. |
| `shapetranslate_translation_dashboard_items` | filter | `array $items, array $args` | Dashboard rows. |
| `shapetranslate_translation_dashboard_complete_statuses` | filter | `string[] $statuses` | Statuses that count as complete. |
| `shapetranslate_translation_dashboard_draft_statuses` | filter | `string[] $statuses` | Statuses that count as draft. |
| `shapetranslate_string_translation_languages` | filter | `array $languages` | Languages in the string editor. |
| `shapetranslate_string_translation_groups` | filter | `string[] $groups` | Groups in the filter. |
| `shapetranslate_string_translation_query_args` | filter | `array $args` | String list query. |
| `shapetranslate_string_translation_items` | filter | `array $items, array $args` | String rows. |

### Strings 8

| Hook | Type | Arguments | When / what |
| --- | --- | --- | --- |
| `shapetranslate_pre_register_string` | filter | `array $input` | String registration before validation. |
| `shapetranslate_registered_string_saved` | action | `array $definition` | A string was registered or its original changed. |
| `shapetranslate_string_translation` | filter | `string $value, array $definition, array $language, bool $has_translation` | The translated value returned. |
| `shapetranslate_string_translation_saved` | action | `string $id, string $lang, string $translation, ?string $previous, array $definition` | A string translation was saved. |
| `shapetranslate_string_translation_deleted` | action | `string $id, string $lang, string $previous` | A string translation was cleared. |
| `shapetranslate_core_string_catalog` | filter | `array $declarations` | Options auto-registered (blogname, tagline …). |
| `shapetranslate_register_core_strings` | filter | `bool $on` | Turn off the built-in string catalog. |
| `shapetranslate_translate_option` | filter | `bool $front_end, string $option` | Substitute the translated option on this request. |

### Routing, URLs & detection 33

| Hook | Type | Arguments | When / what |
| --- | --- | --- | --- |
| `shapetranslate_public_query_var` | filter | `string $var` | Query argument name (default lang). |
| `shapetranslate_enable_frontend_routing` | filter | `bool $on` | Let ShapeTranslate own front-end routes (off while Polylang/WPML is active). |
| `shapetranslate_missing_translation_url` | filter | `string $url, int $object_id, array $language, string $tax` | Fallback URL when there is no translation. |
| `shapetranslate_hide_archive_translation_url` | filter | `bool $hide, array $language, string[] $post_types` | Drop a language from an empty archive. |
| `shapetranslate_language_has_content` | filter | `bool $has, array $language` | Whether the site publishes anything in a language. |
| `shapetranslate_builder_preview_query_args` | filter | `string[] $args` | Query args that mark a builder preview. |
| `shapetranslate_front_door_callers` | filter | `array $rules` | Which home_url() callers mean the site root. |
| `shapetranslate_scope_suppressed_queries` | filter | `bool $on, WP_Query $q` | Scope queries that suppress filters. |
| `shapetranslate_language_query_fallback` | filter | `bool $on, $query, string $lang` | Include untranslated originals in listings. |
| `shapetranslate_filter_terms_by_language` | filter | `bool $on, string $tax, string $lang, array $args` | Filter front-end term lists. |
| `shapetranslate_filter_main_query_by_language` | filter | `bool $on, WP_Query $q` | Filter the main query. |
| `shapetranslate_filter_block_query_by_language` | filter | `bool $on, WP_Query $q` | Filter block-rendered queries. |
| `shapetranslate_filter_secondary_query_by_language` | filter | `bool $on, WP_Query $q` | Filter secondary queries. |
| `shapetranslate_post_query_block_names` | filter | `string[] $blocks` | Blocks that run their own post query. |
| `shapetranslate_constrain_untranslated_archive` | filter | `bool $on, WP_Query $q` | Keep archives of untranslated types constrained. |
| `shapetranslate_unrouted_host_redirect_url` | filter | `string $url, array $default, string $current` | Redirect for a host that serves no language; '' cancels. |
| `shapetranslate_search_form_action` | filter | `string $url, array $language` | Search form action URL. |
| `shapetranslate_same_origin_url` | filter | `string $rewritten, string $url, string $host` | URL moved onto the request's own host. |
| `shapetranslate_subdomain_base_host` | filter | `string $host` | Base host for language subdomains. |
| `shapetranslate_background_request_language_id` | filter | `string $lang` | Language of an AJAX or REST request. |
| `shapetranslate_should_detect_language` | filter | `bool $allowed` | Allow browser detection (e.g. skip bots). |
| `shapetranslate_browser_detection_languages` | filter | `array $languages, string $accept_language` | Candidate languages for detection. |
| `shapetranslate_detected_language_url` | filter | `string $url, array $language` | Detection redirect target; '' cancels. |
| `shapetranslate_language_detected` | action | `array $language, string $url` | Right before the detection redirect. |
| `shapetranslate_exclude_detected_root_from_cache` | filter | `bool $on` | Mark the undecided home page as uncacheable. |
| `shapetranslate_vary_headers` | filter | `string[] $headers` | Vary headers (Accept-Language, Cookie). |
| `shapetranslate_language_cookie_lifetime` | filter | `int $seconds, array $language` | Cookie lifetime (0 = session). |
| `shapetranslate_language_cookie_args` | filter | `array $args, array $language` | setcookie() options. |
| `shapetranslate_request_language_changed` | action | `string $lang` | A REST request switched language. |
| `shapetranslate_editor_language_id` | filter | `string $lang, $context` | Working language in the block editor. |
| `shapetranslate_editor_language_fallback` | filter | `bool $on, $context` | Editor lists include untranslated originals. |
| `shapetranslate_language_rest_routes` | filter | `string[] $routes` | REST routes the editor tags with a language. |
| `shapetranslate_filter_rest_query_by_language` | filter | `bool $on, string $lang, $query, string $type` | Filter REST collections by language. |

### SEO & sitemaps 16

| Hook | Type | Arguments | When / what |
| --- | --- | --- | --- |
| `shapetranslate_language_attributes` | filter | `string $attrs, array $language, string $doctype` | The <html> language attributes. |
| `shapetranslate_hreflang_languages` | filter | `array $languages` | Languages used for hreflang. |
| `shapetranslate_hreflang_urls` | filter | `array $urls` | All hreflang alternates. |
| `shapetranslate_x_default_url` | filter | `string $url, array $alternates, ?array $default` | x-default URL; '' omits it. |
| `shapetranslate_canonical_url` | filter | `string $canonical, ?array $current` | Core canonical URL. |
| `shapetranslate_provider_canonical_url` | filter | `string $prefixed, string $canonical, array $current` | Yoast / Rank Math canonical. |
| `shapetranslate_seo_is_indexable_request` | filter | `bool $indexable` | Output canonical and hreflang at all. |
| `shapetranslate_output_canonical` | filter | `bool $output, string $canonical` | Archive canonical output. |
| `shapetranslate_provider_canonical_filters` | filter | `string[] $hooks` | SEO plugin canonical hooks to wrap. |
| `shapetranslate_canonical_provider_constants` | filter | `string[] $constants` | Constants that mean an SEO plugin owns the canonical. |
| `shapetranslate_has_canonical_provider` | filter | `bool $has` | Another plugin owns the canonical. |
| `shapetranslate_split_sitemaps_by_language` | filter | `bool $split` | One core sitemap per language. |
| `shapetranslate_sitemap_language_ids` | filter | `string[] $ids` | Languages in the sitemap. |
| `shapetranslate_seo_providers` | filter | `array $providers` | Known SEO providers. |
| `shapetranslate_seo_meta_keys` | filter | `string[] $keys, bool $sync, string $lang, array $providers` | SEO meta carried to translations. |
| `shapetranslate_seo_option_strings` | filter | `array $strings` | SEO plugin options registered as strings. |

### Menus & navigation 13

| Hook | Type | Arguments | When / what |
| --- | --- | --- | --- |
| `shapetranslate_menu_language_id` | filter | `string $lang, int $menu_id` | Language of a menu. |
| `shapetranslate_menu_location_assignments` | filter | `array $map` | Theme location × language map. |
| `shapetranslate_menu_configuration_updated` | action | `array $languages, array $locations` | Menu settings saved. |
| `shapetranslate_menu_locations_rejected` | action | `WP_Error $error, array $assignments` | A location assignment was refused. |
| `shapetranslate_override_explicit_nav_menu` | filter | `bool $override, array $args` | Replace a menu passed explicitly to wp_nav_menu(). |
| `shapetranslate_translate_menu_links` | filter | `bool $on, array $items, object $args, array $language` | Point menu links at translations. |
| `shapetranslate_translated_menu_items` | filter | `array $items, object $args, array $language` | Final menu items. |
| `shapetranslate_menu_item_translated` | action | `WP_Post $item, int $target_id, array $language` | One menu item was translated. |
| `shapetranslate_menu_post_translation_available` | filter | `bool $ok, WP_Post $post, WP_Post $item, array $language` | Whether a linked translation may be used. |
| `shapetranslate_menu_missing_translation_behavior` | filter | `string $behavior, object $args, array $language` | preserve, hide, home or current. |
| `shapetranslate_navigation_listing_fallback` | filter | `bool $on, WP_Query $q` | Page List block fallback. |
| `shapetranslate_navigation_menu_id` | filter | `int $translation, int $reference, string $lang` | wp_navigation post used per language. |
| `shapetranslate_translate_navigation_menus` | filter | `bool $on` | Turn off block-theme menu translation. |

### Language switcher 14

| Hook | Type | Arguments | When / what |
| --- | --- | --- | --- |
| `shapetranslate_switcher_default_args` | filter | `array $defaults` | Default switcher arguments. |
| `shapetranslate_switcher_args` | filter | `array $args` | Arguments before normalization. |
| `shapetranslate_switcher_languages` | filter | `array $languages, array $args` | Languages shown. |
| `shapetranslate_switcher_item` | filter | `array $item, array $language, array $args` | One item; return null/false to drop it. |
| `shapetranslate_switcher_items` | filter | `array $items, array $args` | All items. |
| `shapetranslate_switcher_labels` | filter | `array $labels, array $languages, array $args` | Item labels. |
| `shapetranslate_switcher_flag_html` | filter | `string $html, array $language, array $args` | Flag markup. |
| `shapetranslate_switcher_flag_url` | filter | `string $url, array $language, array $args` | Flag image URL. |
| `shapetranslate_switcher_unavailable_url` | filter | `string $url, string $behavior, array $language, array $args` | URL for a missing translation. |
| `shapetranslate_switcher_html` | filter | `string $html, array $items, array $args` | Final switcher HTML. |
| `shapetranslate_switcher_allowed_html` | filter | `array $allowed` | Tags and attributes kept when the switcher HTML is escaped. |
| `shapetranslate_switcher_menu_args` | filter | `array $settings, WP_Post $item, stdClass $args` | Classic menu switcher settings. |
| `shapetranslate_switcher_menu_items` | filter | `array $items, WP_Post $item, array $settings, stdClass $args` | Menu items the switcher expands into. |
| `shapetranslate_render_floating_switcher` | filter | `bool $on, array $config` | Show the floating switcher. |

### Media & cache 3

| Hook | Type | Arguments | When / what |
| --- | --- | --- | --- |
| `shapetranslate_shared_file_siblings` | filter | `int[] $ids, int $object_id, string $meta_key` | Attachments that share a file change. |
| `shapetranslate_media_file_shared` | action | `int $translation_id, int $source_id` | A media translation points at the shared file. |
| `shapetranslate_is_cache_active` | filter | `bool $active` | Treat the site as page-cached (writes the cookie with JS). |

### WPML config 3

| Hook | Type | Arguments | When / what |
| --- | --- | --- | --- |
| `shapetranslate_wpml_config_enabled` | filter | `bool $on` | Apply wpml-config.xml rules. |
| `shapetranslate_wpml_config_files` | filter | `array $files` | wpml-config.xml files to read. |
| `shapetranslate_wpml_config_rules` | filter | `array $rules` | Parsed rules. |

### Elementor & theme builders 50

| Hook | Type | Arguments | When / what |
| --- | --- | --- | --- |
| `shapetranslate_elementor_available` | filter | `bool $available` | Elementor support on/off. |
| `shapetranslate_is_elementor_document` | filter | `bool $is, int $post_id, ?WP_Post $post` | Whether a post is an Elementor document. |
| `shapetranslate_elementor_copy_meta_keys` | filter | `string[] $keys, int $source, int $target` | Elementor meta copied. |
| `shapetranslate_elementor_copy_meta_value` | filter | `mixed $value, string $key, int $source, int $target` | Elementor meta value copied. |
| `shapetranslate_elementor_generated_meta_keys` | filter | `string[] $keys, int $target, int $source` | Generated meta to clear. |
| `shapetranslate_elementor_document_copied` | action | `int $target, int $source, bool $copy_content` | Elementor data copied. |
| `shapetranslate_elementor_document_copy_failed` | action | `WP_Error $error, int $new_id, int $source, array $language, string $group` | Copy failed. |
| `shapetranslate_elementor_pro_available` | filter | `bool $available` | Elementor Pro detected. |
| `shapetranslate_elementor_translate_templates` | filter | `bool $on` | Theme Builder templates are translatable. |
| `shapetranslate_elementor_translate_conditions` | filter | `bool $on, int $target, string $lang` | Rewrite display conditions. |
| `shapetranslate_elementor_translate_condition_sub_id` | filter | `bool $on, array $condition, string $lang` | Translate IDs inside a condition. |
| `shapetranslate_elementor_location_template_id` | filter | `int $id, int $template_id, string $location, string $lang` | Template used for a location. |
| `shapetranslate_elementskit_available` | filter | `bool` | ElementsKit detected. |
| `shapetranslate_elementskit_template_id` | filter | `int $id, int $source, int|string $slot, string $lang` | Header/footer template per language. |
| `shapetranslate_elementskit_atomic_styles` | filter | `bool $on, int $template_id` | Load template styles. |
| `shapetranslate_elementskit_translate_templates` | filter | `bool $on` | ElementsKit templates translatable. |
| `shapetranslate_elementskit_translate_conditions` | filter | `bool $on, int $target, string $lang` | Rewrite conditions. |
| `shapetranslate_eael_available` | filter | `bool` | Essential Addons detected. |
| `shapetranslate_eael_template_id` | filter | `int $id, int $source, string $type, string $lang` | Template per language. |
| `shapetranslate_eael_translate_templates` | filter | `bool $on` | Templates translatable. |
| `shapetranslate_eael_translate_conditions` | filter | `bool $on, int $target, string $lang` | Rewrite conditions. |
| `shapetranslate_happyaddons_available` | filter | `bool` | Happy Addons detected. |
| `shapetranslate_happyaddons_template_id` | filter | `int $id, int $source, string $lang` | Template per language. |
| `shapetranslate_happyaddons_template_styles` | filter | `bool $on, int $rendered, int $source` | Load template styles. |
| `shapetranslate_happyaddons_record_conditions` | filter | `bool $on, int $post_id` | Record conditions. |
| `shapetranslate_happyaddons_translate_templates` | filter | `bool $on` | Templates translatable. |
| `shapetranslate_happyaddons_translate_conditions` | filter | `bool $on, int $target, string $lang` | Rewrite conditions. |
| `shapetranslate_happyaddons_match_untranslated` | filter | `bool $on` | Fall back to untranslated templates. |
| `shapetranslate_hfe_available` | filter | `bool` | Elementor Header & Footer Builder detected. |
| `shapetranslate_hfe_translate_templates` | filter | `bool $on` | Templates translatable. |
| `shapetranslate_hfe_matched_templates` | filter | `array $selected, array $templates, string $lang` | Templates matched for a page. |
| `shapetranslate_hfe_template_id` | filter | `int $id, int $source, string $lang` | Template per language. |
| `shapetranslate_hfe_translate_locations` | filter | `bool $on, int $target, string $lang` | Rewrite display locations. |
| `shapetranslate_elementpack_available` | filter | `bool $available` | Element Pack detected. |
| `shapetranslate_elementpack_template_id` | filter | `int $id, int $source, string $slot, string $lang` | Header/footer template per language. |
| `shapetranslate_elementpack_page_template_id` | filter | `int $id, int $source, string $lang` | Page template per language. |
| `shapetranslate_elementpack_template_styles` | filter | `bool $on, int $template_id` | Load template styles. |
| `shapetranslate_elementpack_translate_templates` | filter | `bool $on` | Element Pack templates translatable. |
| `shapetranslate_elementpack_translate_conditions` | filter | `bool $on, int $target, string $lang` | Rewrite conditions. |
| `shapetranslate_jegkit_available` | filter | `bool` | Jeg Kit detected. |
| `shapetranslate_jegkit_expose_templates` | filter | `bool $on, string $post_type` | Show templates in the translation UI. |
| `shapetranslate_jegkit_template_title` | filter | `string $named, string $title, array $language, WP_Post $source` | Title of a translated template. |
| `shapetranslate_jegkit_template_id` | filter | `int $id, string $post_type, int $post_id, string $lang` | Template per language. |
| `shapetranslate_jegkit_translate_templates` | filter | `bool $on` | Templates translatable. |
| `shapetranslate_jegkit_translate_conditions` | filter | `bool $on, int $target, string $lang` | Rewrite conditions. |
| `shapetranslate_jegkit_dashboard_languages` | filter | `bool $on` | Language labels on the Jeg Kit dashboard. |
| `shapetranslate_royaladdons_available` | filter | `bool` | Royal Elementor Addons detected. |
| `shapetranslate_royaladdons_template_styles` | filter | `bool $on, int $template_id` | Load template styles. |
| `shapetranslate_royaladdons_conditions` | filter | `array $translated, array $conditions, string $lang` | Translated conditions. |
| `shapetranslate_royaladdons_translate_templates` | filter | `bool $on` | Templates translatable. |

### Site Editor 10

| Hook | Type | Arguments | When / what |
| --- | --- | --- | --- |
| `shapetranslate_site_editor_available` | filter | `bool $on` | Site Editor integration (block themes). |
| `shapetranslate_translate_templates` | filter | `bool $on` | Turn off whole-template translation. |
| `shapetranslate_translate_template_parts` | filter | `bool $on` | Turn off template-part translation. |
| `shapetranslate_template_part_content` | filter | `string $content, WP_Post $source, string $lang` | Starting content of a new part version. |
| `shapetranslate_template_part_created` | action | `int $post_id, int $source_id, string $lang` | A part version was created or adopted. |
| `shapetranslate_template_part_slugs` | filter | `string[] $slugs, string[] $requested, string $lang` | Slugs tried for a part. |
| `shapetranslate_template_part_language` | filter | `string $lang` | Render language of parts. |
| `shapetranslate_template_hierarchy` | filter | `string[] $widened, string[] $templates, string $lang` | Language-aware template hierarchy. |
| `shapetranslate_template_language` | filter | `string $lang` | Render language of templates. |
| `shapetranslate_delete_template_part_translations` | filter | `bool $on, int $post_id, string $post_type` | Deleting the source deletes its versions. |
