diff --git a/composer.lock b/composer.lock
index 76d73d00..571cb1b2 100644
--- a/composer.lock
+++ b/composer.lock
@@ -8,16 +8,16 @@
     "packages": [
         {
             "name": "doctrine/deprecations",
-            "version": "1.1.2",
+            "version": "1.1.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/doctrine/deprecations.git",
-                "reference": "4f2d4f2836e7ec4e7a8625e75c6aa916004db931"
+                "reference": "dfbaa3c2d2e9a9df1118213f3b8b0c597bb99fab"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/doctrine/deprecations/zipball/4f2d4f2836e7ec4e7a8625e75c6aa916004db931",
-                "reference": "4f2d4f2836e7ec4e7a8625e75c6aa916004db931",
+                "url": "https://api.github.com/repos/doctrine/deprecations/zipball/dfbaa3c2d2e9a9df1118213f3b8b0c597bb99fab",
+                "reference": "dfbaa3c2d2e9a9df1118213f3b8b0c597bb99fab",
                 "shasum": ""
             },
             "require": {
@@ -49,27 +49,27 @@
             "homepage": "https://www.doctrine-project.org/",
             "support": {
                 "issues": "https://github.com/doctrine/deprecations/issues",
-                "source": "https://github.com/doctrine/deprecations/tree/1.1.2"
+                "source": "https://github.com/doctrine/deprecations/tree/1.1.3"
             },
-            "time": "2023-09-27T20:04:15+00:00"
+            "time": "2024-01-30T19:34:25+00:00"
         },
         {
             "name": "nikic/php-parser",
-            "version": "v4.17.1",
+            "version": "v4.19.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/nikic/PHP-Parser.git",
-                "reference": "a6303e50c90c355c7eeee2c4a8b27fe8dc8fef1d"
+                "reference": "4e1b88d21c69391150ace211e9eaf05810858d0b"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/nikic/PHP-Parser/zipball/a6303e50c90c355c7eeee2c4a8b27fe8dc8fef1d",
-                "reference": "a6303e50c90c355c7eeee2c4a8b27fe8dc8fef1d",
+                "url": "https://api.github.com/repos/nikic/PHP-Parser/zipball/4e1b88d21c69391150ace211e9eaf05810858d0b",
+                "reference": "4e1b88d21c69391150ace211e9eaf05810858d0b",
                 "shasum": ""
             },
             "require": {
                 "ext-tokenizer": "*",
-                "php": ">=7.0"
+                "php": ">=7.1"
             },
             "require-dev": {
                 "ircmaxell/php-yacc": "^0.0.7",
@@ -105,9 +105,9 @@
             ],
             "support": {
                 "issues": "https://github.com/nikic/PHP-Parser/issues",
-                "source": "https://github.com/nikic/PHP-Parser/tree/v4.17.1"
+                "source": "https://github.com/nikic/PHP-Parser/tree/v4.19.1"
             },
-            "time": "2023-08-13T19:53:39+00:00"
+            "time": "2024-03-17T08:10:35+00:00"
         },
         {
             "name": "phpdocumentor/reflection",
@@ -228,28 +228,35 @@
         },
         {
             "name": "phpdocumentor/reflection-docblock",
-            "version": "5.3.0",
+            "version": "5.4.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/phpDocumentor/ReflectionDocBlock.git",
-                "reference": "622548b623e81ca6d78b721c5e029f4ce664f170"
+                "reference": "9d07b3f7fdcf5efec5d1609cba3c19c5ea2bdc9c"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/phpDocumentor/ReflectionDocBlock/zipball/622548b623e81ca6d78b721c5e029f4ce664f170",
-                "reference": "622548b623e81ca6d78b721c5e029f4ce664f170",
+                "url": "https://api.github.com/repos/phpDocumentor/ReflectionDocBlock/zipball/9d07b3f7fdcf5efec5d1609cba3c19c5ea2bdc9c",
+                "reference": "9d07b3f7fdcf5efec5d1609cba3c19c5ea2bdc9c",
                 "shasum": ""
             },
             "require": {
+                "doctrine/deprecations": "^1.1",
                 "ext-filter": "*",
-                "php": "^7.2 || ^8.0",
+                "php": "^7.4 || ^8.0",
                 "phpdocumentor/reflection-common": "^2.2",
-                "phpdocumentor/type-resolver": "^1.3",
+                "phpdocumentor/type-resolver": "^1.7",
+                "phpstan/phpdoc-parser": "^1.7",
                 "webmozart/assert": "^1.9.1"
             },
             "require-dev": {
-                "mockery/mockery": "~1.3.2",
-                "psalm/phar": "^4.8"
+                "mockery/mockery": "~1.3.5",
+                "phpstan/extension-installer": "^1.1",
+                "phpstan/phpstan": "^1.8",
+                "phpstan/phpstan-mockery": "^1.1",
+                "phpstan/phpstan-webmozart-assert": "^1.2",
+                "phpunit/phpunit": "^9.5",
+                "vimeo/psalm": "^5.13"
             },
             "type": "library",
             "extra": {
@@ -273,33 +280,33 @@
                 },
                 {
                     "name": "Jaap van Otterdijk",
-                    "email": "account@ijaap.nl"
+                    "email": "opensource@ijaap.nl"
                 }
             ],
             "description": "With this component, a library can provide support for annotations via DocBlocks or otherwise retrieve information that is embedded in a DocBlock.",
             "support": {
                 "issues": "https://github.com/phpDocumentor/ReflectionDocBlock/issues",
-                "source": "https://github.com/phpDocumentor/ReflectionDocBlock/tree/5.3.0"
+                "source": "https://github.com/phpDocumentor/ReflectionDocBlock/tree/5.4.1"
             },
-            "time": "2021-10-19T17:43:47+00:00"
+            "time": "2024-05-21T05:55:05+00:00"
         },
         {
             "name": "phpdocumentor/type-resolver",
-            "version": "1.7.3",
+            "version": "1.8.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/phpDocumentor/TypeResolver.git",
-                "reference": "3219c6ee25c9ea71e3d9bbaf39c67c9ebd499419"
+                "reference": "153ae662783729388a584b4361f2545e4d841e3c"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/phpDocumentor/TypeResolver/zipball/3219c6ee25c9ea71e3d9bbaf39c67c9ebd499419",
-                "reference": "3219c6ee25c9ea71e3d9bbaf39c67c9ebd499419",
+                "url": "https://api.github.com/repos/phpDocumentor/TypeResolver/zipball/153ae662783729388a584b4361f2545e4d841e3c",
+                "reference": "153ae662783729388a584b4361f2545e4d841e3c",
                 "shasum": ""
             },
             "require": {
                 "doctrine/deprecations": "^1.0",
-                "php": "^7.4 || ^8.0",
+                "php": "^7.3 || ^8.0",
                 "phpdocumentor/reflection-common": "^2.0",
                 "phpstan/phpdoc-parser": "^1.13"
             },
@@ -337,22 +344,22 @@
             "description": "A PSR-5 based resolver of Class names, Types and Structural Element Names",
             "support": {
                 "issues": "https://github.com/phpDocumentor/TypeResolver/issues",
-                "source": "https://github.com/phpDocumentor/TypeResolver/tree/1.7.3"
+                "source": "https://github.com/phpDocumentor/TypeResolver/tree/1.8.2"
             },
-            "time": "2023-08-12T11:01:26+00:00"
+            "time": "2024-02-23T11:10:43+00:00"
         },
         {
             "name": "phpstan/phpdoc-parser",
-            "version": "1.24.2",
+            "version": "1.29.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/phpstan/phpdoc-parser.git",
-                "reference": "bcad8d995980440892759db0c32acae7c8e79442"
+                "reference": "fcaefacf2d5c417e928405b71b400d4ce10daaf4"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/phpstan/phpdoc-parser/zipball/bcad8d995980440892759db0c32acae7c8e79442",
-                "reference": "bcad8d995980440892759db0c32acae7c8e79442",
+                "url": "https://api.github.com/repos/phpstan/phpdoc-parser/zipball/fcaefacf2d5c417e928405b71b400d4ce10daaf4",
+                "reference": "fcaefacf2d5c417e928405b71b400d4ce10daaf4",
                 "shasum": ""
             },
             "require": {
@@ -384,9 +391,9 @@
             "description": "PHPDoc parser with support for nullable, intersection and generic types",
             "support": {
                 "issues": "https://github.com/phpstan/phpdoc-parser/issues",
-                "source": "https://github.com/phpstan/phpdoc-parser/tree/1.24.2"
+                "source": "https://github.com/phpstan/phpdoc-parser/tree/1.29.1"
             },
-            "time": "2023-09-26T12:28:12+00:00"
+            "time": "2024-05-31T08:52:43+00:00"
         },
         {
             "name": "psr/container",
@@ -528,16 +535,16 @@
         },
         {
             "name": "symfony/deprecation-contracts",
-            "version": "v2.5.2",
+            "version": "v2.5.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/deprecation-contracts.git",
-                "reference": "e8b495ea28c1d97b5e0c121748d6f9b53d075c66"
+                "reference": "80d075412b557d41002320b96a096ca65aa2c98d"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/e8b495ea28c1d97b5e0c121748d6f9b53d075c66",
-                "reference": "e8b495ea28c1d97b5e0c121748d6f9b53d075c66",
+                "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/80d075412b557d41002320b96a096ca65aa2c98d",
+                "reference": "80d075412b557d41002320b96a096ca65aa2c98d",
                 "shasum": ""
             },
             "require": {
@@ -575,7 +582,7 @@
             "description": "A generic function and convention to trigger deprecation notices",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/deprecation-contracts/tree/v2.5.2"
+                "source": "https://github.com/symfony/deprecation-contracts/tree/v2.5.3"
             },
             "funding": [
                 {
@@ -591,7 +598,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-01-02T09:53:40+00:00"
+            "time": "2023-01-24T14:02:46+00:00"
         },
         {
             "name": "symfony/filesystem",
@@ -658,16 +665,16 @@
         },
         {
             "name": "symfony/polyfill-ctype",
-            "version": "v1.28.0",
+            "version": "v1.29.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-ctype.git",
-                "reference": "ea208ce43cbb04af6867b4fdddb1bdbf84cc28cb"
+                "reference": "ef4d7e442ca910c4764bce785146269b30cb5fc4"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/ea208ce43cbb04af6867b4fdddb1bdbf84cc28cb",
-                "reference": "ea208ce43cbb04af6867b4fdddb1bdbf84cc28cb",
+                "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/ef4d7e442ca910c4764bce785146269b30cb5fc4",
+                "reference": "ef4d7e442ca910c4764bce785146269b30cb5fc4",
                 "shasum": ""
             },
             "require": {
@@ -681,9 +688,6 @@
             },
             "type": "library",
             "extra": {
-                "branch-alias": {
-                    "dev-main": "1.28-dev"
-                },
                 "thanks": {
                     "name": "symfony/polyfill",
                     "url": "https://github.com/symfony/polyfill"
@@ -720,7 +724,7 @@
                 "portable"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-ctype/tree/v1.28.0"
+                "source": "https://github.com/symfony/polyfill-ctype/tree/v1.29.0"
             },
             "funding": [
                 {
@@ -736,20 +740,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2023-01-26T09:26:14+00:00"
+            "time": "2024-01-29T20:11:03+00:00"
         },
         {
             "name": "symfony/polyfill-mbstring",
-            "version": "v1.28.0",
+            "version": "v1.29.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-mbstring.git",
-                "reference": "42292d99c55abe617799667f454222c54c60e229"
+                "reference": "9773676c8a1bb1f8d4340a62efe641cf76eda7ec"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/42292d99c55abe617799667f454222c54c60e229",
-                "reference": "42292d99c55abe617799667f454222c54c60e229",
+                "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/9773676c8a1bb1f8d4340a62efe641cf76eda7ec",
+                "reference": "9773676c8a1bb1f8d4340a62efe641cf76eda7ec",
                 "shasum": ""
             },
             "require": {
@@ -763,9 +767,6 @@
             },
             "type": "library",
             "extra": {
-                "branch-alias": {
-                    "dev-main": "1.28-dev"
-                },
                 "thanks": {
                     "name": "symfony/polyfill",
                     "url": "https://github.com/symfony/polyfill"
@@ -803,7 +804,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.28.0"
+                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.29.0"
             },
             "funding": [
                 {
@@ -819,20 +820,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2023-07-28T09:04:16+00:00"
+            "time": "2024-01-29T20:11:03+00:00"
         },
         {
             "name": "symfony/polyfill-php73",
-            "version": "v1.28.0",
+            "version": "v1.29.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-php73.git",
-                "reference": "fe2f306d1d9d346a7fee353d0d5012e401e984b5"
+                "reference": "21bd091060673a1177ae842c0ef8fe30893114d2"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php73/zipball/fe2f306d1d9d346a7fee353d0d5012e401e984b5",
-                "reference": "fe2f306d1d9d346a7fee353d0d5012e401e984b5",
+                "url": "https://api.github.com/repos/symfony/polyfill-php73/zipball/21bd091060673a1177ae842c0ef8fe30893114d2",
+                "reference": "21bd091060673a1177ae842c0ef8fe30893114d2",
                 "shasum": ""
             },
             "require": {
@@ -840,9 +841,6 @@
             },
             "type": "library",
             "extra": {
-                "branch-alias": {
-                    "dev-main": "1.28-dev"
-                },
                 "thanks": {
                     "name": "symfony/polyfill",
                     "url": "https://github.com/symfony/polyfill"
@@ -882,7 +880,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php73/tree/v1.28.0"
+                "source": "https://github.com/symfony/polyfill-php73/tree/v1.29.0"
             },
             "funding": [
                 {
@@ -898,20 +896,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2023-01-26T09:26:14+00:00"
+            "time": "2024-01-29T20:11:03+00:00"
         },
         {
             "name": "symfony/polyfill-php80",
-            "version": "v1.28.0",
+            "version": "v1.29.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-php80.git",
-                "reference": "6caa57379c4aec19c0a12a38b59b26487dcfe4b5"
+                "reference": "87b68208d5c1188808dd7839ee1e6c8ec3b02f1b"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php80/zipball/6caa57379c4aec19c0a12a38b59b26487dcfe4b5",
-                "reference": "6caa57379c4aec19c0a12a38b59b26487dcfe4b5",
+                "url": "https://api.github.com/repos/symfony/polyfill-php80/zipball/87b68208d5c1188808dd7839ee1e6c8ec3b02f1b",
+                "reference": "87b68208d5c1188808dd7839ee1e6c8ec3b02f1b",
                 "shasum": ""
             },
             "require": {
@@ -919,9 +917,6 @@
             },
             "type": "library",
             "extra": {
-                "branch-alias": {
-                    "dev-main": "1.28-dev"
-                },
                 "thanks": {
                     "name": "symfony/polyfill",
                     "url": "https://github.com/symfony/polyfill"
@@ -965,7 +960,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php80/tree/v1.28.0"
+                "source": "https://github.com/symfony/polyfill-php80/tree/v1.29.0"
             },
             "funding": [
                 {
@@ -981,20 +976,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2023-01-26T09:26:14+00:00"
+            "time": "2024-01-29T20:11:03+00:00"
         },
         {
             "name": "symfony/service-contracts",
-            "version": "v2.5.2",
+            "version": "v2.5.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/service-contracts.git",
-                "reference": "4b426aac47d6427cc1a1d0f7e2ac724627f5966c"
+                "reference": "a2329596ddc8fd568900e3fc76cba42489ecc7f3"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/4b426aac47d6427cc1a1d0f7e2ac724627f5966c",
-                "reference": "4b426aac47d6427cc1a1d0f7e2ac724627f5966c",
+                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/a2329596ddc8fd568900e3fc76cba42489ecc7f3",
+                "reference": "a2329596ddc8fd568900e3fc76cba42489ecc7f3",
                 "shasum": ""
             },
             "require": {
@@ -1048,7 +1043,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/service-contracts/tree/v2.5.2"
+                "source": "https://github.com/symfony/service-contracts/tree/v2.5.3"
             },
             "funding": [
                 {
@@ -1064,20 +1059,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-05-30T19:17:29+00:00"
+            "time": "2023-04-21T15:04:16+00:00"
         },
         {
             "name": "timber/teak",
-            "version": "1.0.5",
+            "version": "1.0.6",
             "source": {
                 "type": "git",
                 "url": "https://github.com/timber/teak.git",
-                "reference": "a5af1504cadb8e5d2277069165caf948d1d0c012"
+                "reference": "780977298163b40549d51e8657c1d1b5154284d0"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/timber/teak/zipball/a5af1504cadb8e5d2277069165caf948d1d0c012",
-                "reference": "a5af1504cadb8e5d2277069165caf948d1d0c012",
+                "url": "https://api.github.com/repos/timber/teak/zipball/780977298163b40549d51e8657c1d1b5154284d0",
+                "reference": "780977298163b40549d51e8657c1d1b5154284d0",
                 "shasum": ""
             },
             "require": {
@@ -1114,9 +1109,9 @@
             "description": "Generate a Markdown reference documentation for PHP projects (optimized for WordPress)",
             "support": {
                 "issues": "https://github.com/timber/teak/issues",
-                "source": "https://github.com/timber/teak/tree/1.0.5"
+                "source": "https://github.com/timber/teak/tree/1.0.6"
             },
-            "time": "2022-02-07T20:46:57+00:00"
+            "time": "2024-04-26T12:47:48+00:00"
         },
         {
             "name": "webmozart/assert",
@@ -1187,5 +1182,5 @@
         "php": ">=7.4.0"
     },
     "platform-dev": [],
-    "plugin-api-version": "2.3.0"
+    "plugin-api-version": "2.6.0"
 }
diff --git a/content/v2/hooks/actions.md b/content/v2/hooks/actions.md
index c0acc1e4..47ce75f2 100644
--- a/content/v2/hooks/actions.md
+++ b/content/v2/hooks/actions.md
@@ -3,3 +3,63 @@ title: "Action Hooks"
 is_reference: true
 ---
 
+## timber\_{$object\_type}\_get\_meta\_pre
+
+Filters post meta data before it is fetched from the database.
+
+**DEPRECATED** since 2.0.0, use `timber/{object_type}/pre_meta`
+
+## timber/loader/render\_file
+
+Fires after …
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $result | `string` |  |
+
+## timber\_loader\_render\_file
+
+Fires after …
+
+**DEPRECATED** since 2.0.0, use `timber/loader/render_file`
+
+This action is used by the Timber Debug Bar extension.
+
+## timber/calling\_php\_file
+
+Fires after the calling PHP file was determined in Timber’s compile
+function.
+
+This action is used by the Timber Debug Bar extension.
+
+**since** 1.1.2
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $caller_file | `string` or `null` | The calling script file. |
+
+## timber/compile/done
+
+Fires after a Twig template was compiled and before the compiled data
+is returned.
+
+This action can be helpful if you need to debug Twig template
+compilation.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $output | `string` | The compiled output. |
+| $file | `string` | The name of the Twig template that was compiled. |
+| $data | `array` | The data that was used to compile the Twig template. |
+| $expires | `bool` or `int` or `array` | The expiration time of the cache in seconds, or false to disable cache. |
+| $cache_mode | `string` | Any of the cache mode constants defined in Timber\Loader. |
+
+## timber\_compile\_done
+
+Fires after a Twig template was compiled and before the compiled data
+is returned.
+
+**DEPRECATED** since 2.0.0, use `timber/compile/done`
+
diff --git a/content/v2/hooks/filters.md b/content/v2/hooks/filters.md
index a1bbbfac..4ea07449 100644
--- a/content/v2/hooks/filters.md
+++ b/content/v2/hooks/filters.md
@@ -3,3 +3,1619 @@ title: "Filter Hooks"
 is_reference: true
 ---
 
+## timber/meta/transform\_value
+
+Filters whether to transform a meta value.
+
+If the filter returns `true`, all meta value will be transformed to Timber/standard PHP objects if possible.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $transform_value | `bool` |  |
+
+**PHP**
+
+```php
+// Transforms all meta value.
+add_filter( 'timber/meta/transform_value', '__return_true' );
+```
+
+## timber/{$object\_type}/pre\_meta
+
+Filters object meta data before it is fetched from the database.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $object_meta | `string` or `null` | The field value. Default null. Passing a non-null value will skip fetching the value from the database and will use the value from the filter instead. |
+| $post_id | `int` | The post ID. |
+| $field_name | `string` | The name of the meta field to get the value for. |
+| $object | `object` | The Timber object. |
+| $args | `array` | An array of arguments. |
+
+**PHP**
+
+```php
+// Disable fetching meta values.
+add_filter( 'timber/post/pre_meta', '__return_false' );
+
+// Add your own meta data.
+add_filter( 'timber/post/pre_meta', function( $post_meta, $post_id, $post ) {
+    $post_meta = array_merge( $post_meta, [
+        'custom_data_1' => 73,
+        'custom_data_2' => 274,
+    ] );
+
+    return $post_meta;
+}, 10, 3 );
+```
+
+## timber\_{$object\_type}\_get\_meta\_field\_pre
+
+Filters the value for a post meta field before it is fetched from the database.
+
+**DEPRECATED** since 2.0.0, use `timber/{object_type}/pre_meta`
+
+## timber/{$object\_type}/meta
+
+Filters the value for a post meta field.
+
+This filter is used by the ACF Integration.
+
+**see** [Timber\Post::meta()](/docs/reference/timber-post/#meta)
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $post_meta | `string` | The field value. |
+| $post_id | `int` | The post ID. |
+| $field_name | `string` | The name of the meta field to get the value for. |
+| $post | `\CoreEntity` | The post object. |
+| $args | `array` | An array of arguments. |
+
+**PHP**
+
+```php
+add_filter( 'timber/post/meta', function( $post_meta, $post_id, $field_name, $post ) {
+    if ( 'event' === $post->post_type ) {
+        // Do something special.
+        $post_meta['foo'] = $post_meta['foo'] . ' bar';
+    }
+
+    return $post_meta;
+}, 10, 4 );
+```
+
+## timber/term/meta/field
+
+Filters the value for a term meta field.
+
+**DEPRECATED** since 2.0.0, use `timber/term/meta`
+
+## timber\_{$object\_type}\_get\_meta\_field
+
+Filters the value for an object meta field.
+
+**DEPRECATED** since 2.0.0, use `timber/{object_type}/meta`
+
+## timber\_{$object\_type}\_get\_meta
+
+Filters object meta data fetched from the database.
+
+**DEPRECATED** since 2.0.0, use `timber/{object_type}/meta`
+
+## timber/comment/classmap
+
+Filters the class(es) used for comments linked to different post types.
+
+The default class is Timber\Comment. You can use this filter to provide your own comment class for specific post types.
+
+Make sure to merge in your additional classes instead of overwriting the whole Class Map.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $classmap | `array` | The post class(es) to use. An associative array where the key is the post type and the value the name of the class to use for the comments of this post type or a callback that determines the class to use. |
+
+```
+use Book;
+
+add_filter( 'timber/post/classmap', function( $classmap ) {
+    $custom_classmap = [
+        'book' => BookComment::class,
+    ];
+
+    return array_merge( $classmap, $custom_classmap );
+} );
+```
+
+## timber/comment/class
+
+Filters the comment class based on your custom criteria.
+
+Maybe you want to set a custom class based upon the comment type?
+This allows you to filter the PHP class, utilizing data from the WP_Comment object.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $class | `string` | The class to use. |
+| $comment | `\WP_Comment` | The comment object. |
+
+```
+add_filter( 'timber/comment/class', function( $class, $comment ) {
+    if ( $comment->comment_type === 'pingback' ) {
+        return PingBackComment::class;
+    }
+    return $class;
+}, 10, 2 );
+```
+
+## timber/menu/classmap
+
+Filters the class(es) used for different menus.
+
+Read more about this in the documentation for [Menu Class Maps](https://timber.github.io/docs/v2/guides/class-maps/#the-menu-class-map).
+
+The default Menu Class Map will contain class names for locations that map to `Timber\Menu`.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $classmap | `array` | The menu class(es) to use. An associative array where the key is the location and the value the name of the class to use for this menu or a callback that determines the class to use. |
+
+```
+add_filter( 'timber/menu/classmap', function( $classmap ) {
+    $custom_classmap = [
+        'primary'   => MenuPrimary::class,
+        'secondary' => MenuSecondary::class,
+    ];
+
+    return array_merge( $classmap, $custom_classmap );
+} );
+```
+
+## timber/menu/class
+
+Filters the menu class based on your custom criteria.
+
+Maybe the location is not appropriate in some cases. This filter will allow you to filter the class
+on whatever data is available.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $class | `string` | The class to use. |
+| $term | `\WP_Term` | The menu term. |
+| $args | `array` | The arguments passed to the menu. |
+
+```
+add_filter( 'timber/menu/class', function( $class, $term, $args ) {
+    if ( $args['depth'] === 1 ) {
+        return SingleLevelMenu::class;
+    }
+
+    return MultiLevelMenu::class;
+}, 10, 3 );
+```
+
+## timber/menuitem/classmap
+
+Filters the class(es) used for different menu items.
+
+Read more about this in the documentation for [Menu Item Class Maps](https://timber.github.io/docs/v2/guides/class-maps/#the-menu-item-class-map).
+
+The default Menu Item Class Map will contain class names for locations that map to `Timber\MenuItem`.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $classmap | `array` | The menu item class(es) to use. An associative array where the key is the location and the value the name of the class to use for this menu item or a callback that determines the class to use. |
+
+```
+add_filter( 'timber/menuitem/classmap', function( $classmap ) {
+    $custom_classmap = [
+        'primary'   => MenuItemFooter::class,
+        'secondary' => MenuItemHeader::class,
+    ];
+
+    return array_merge( $classmap, $custom_classmap );
+} );
+```
+
+## timber/menuitem/class
+
+Filters the menu item class
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $class | `string` | The class to use. |
+| $item | `\WP_Post` | The menu item. |
+| $menu | `\Menu` | The menu object. |
+
+```
+add_filter( 'timber/menuitem/class', function( $class, $item, $menu ) {
+    if ( $item->post_parent ) {
+        return SubMenuItem::class;
+    }
+
+    return MenuItem::class;
+}, 10, 3 );
+```
+
+## timber/pages\_menu/class
+
+Filters the class used for different menus.
+
+Read more about this in the documentation for [Pages Menu Class filter](https://timber.github.io/docs/v2/guides/class-maps/#the-pages-menu-class-filter).
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $class | `string` | The pages menu class to use. |
+| $args | `array` | The arguments passed to `Timber::get_pages_menu()`. |
+
+```
+add_filter( 'timber/pages_menu/class', function( $class ) {
+    return ExtendedPagesMenu::class;
+} );
+```
+
+## timber/post/classmap
+
+Filters the class(es) used for different post types.
+
+Read more about this in the documentation for [Post Class Maps](https://timber.github.io/docs/v2/guides/class-maps/#the-post-class-map).
+
+The default Post Class Map will contain class names for posts, pages that map to
+`Timber\Post` and a callback that will map attachments to `Timber\Attachment` and
+attachments that are images to `Timber\Image`.
+
+Make sure to merge in your additional classes instead of overwriting the whole Class Map.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $classmap | `array` | The post class(es) to use. An associative array where the key is the post type and the value the name of the class to use for this post type or a callback that determines the class to use. |
+
+```
+use Book;
+use Page;
+
+add_filter( 'timber/post/classmap', function( $classmap ) {
+    $custom_classmap = [
+        'page' => Page::class,
+        'book' => Book::class,
+    ];
+
+    return array_merge( $classmap, $custom_classmap );
+} );
+```
+
+## timber/post/class
+
+Filters the post class based on your custom criteria.
+
+Maybe you want to set a custom class based upon how blocks are used?
+This allows you to filter the PHP class, utilizing data from the WP_Post object.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $class | `string` | The class to use. |
+| $post | `\WP_Post` | The post object. |
+
+```
+add_filter( 'timber/post/class', function( $class, $post ) {
+    if ( has_blocks($post) ) {
+        return GutenbergPost::class;
+    }
+
+    return $class;
+}, 10, 2 );
+```
+
+## timber/post/image\_extensions
+
+Filters the list of image extensions that will be used to determine if an attachment is an image.
+
+You can use this filter to add or remove image extensions to the list of extensions that will be
+used to determine if an attachment is an image.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $extensions | `array` | An array of image extensions. |
+
+## timber/term/classmap
+
+Filters the class(es) used for terms of different taxonomies.
+
+The default Term Class Map will contain class names mapped to the build-in post_tag and category taxonomies.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $classmap | `array` | The term class(es) to use. An associative array where the key is the taxonomy name and the value the name of the class to use for this taxonomy or a callback that determines the class to use. |
+
+```
+add_filter( 'timber/term/classmap', function( $classmap ) {
+    $custom_classmap = [
+        'expertise'   => ExpertiseTerm::class,
+    ];
+
+    return array_merge( $classmap, $custom_classmap );
+} );
+```
+
+## timber/term/class
+
+Filters the term class based on your custom criteria.
+
+Maybe you want to set a custom class based upon a certain category?
+This allows you to filter the PHP class, utilizing data from the WP_Term object.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $class | `string` | The class to use. |
+| $term | `\WP_Term` | The term object. |
+
+```
+add_filter( 'timber/term/class', function( $class, $term ) {
+    if ( get_term_meta($term->term_id, 'is_special_category', true) ) {
+        return MyCustomTermClass::class;
+    }
+
+    return $class;
+}, 10, 2 );
+```
+
+## timber/user/class
+
+Filters the name of the PHP class used to instantiate `Timber\User` objects.
+
+The User Class Map receives the default `Timber\User` class and a `WP_User` object. You
+should be able to decide which class to use based on that user object.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $class | `string` | The name of the class. Default `Timber\User`. |
+| $user | `\WP_User` | The `WP_User` object that is used as the base for the `Timber\User` object. |
+
+**PHP**
+
+```php
+use Administrator;
+use Editor;
+
+add_filter( 'timber/user/class', function( $class, \WP_User $user ) {
+    if ( in_array( 'editor', $user->roles, true ) ) {
+        return Editor::class;
+    } elseif ( in_array( 'author', $user->roles, true ) ) {
+        return Author::class;
+    }
+
+    return $class;
+}, 10, 2 );
+```
+
+## timber/transient/slug
+
+Filters the transient slug.
+
+This might be useful if you are using a multilingual solution.
+
+**since** 0.22.6
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $slug | `string` | The slug for the transient. |
+
+## timber/transient/force\_transients
+
+Filters whether to force a locked transients to be regenerated.
+
+If a transient is locked, it means that another process is currently generating the data.
+If you want to force the transient to be regenerated, during that process, you can set this
+filter to true.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $force | `bool` | Whether to force a locked transient to be regenerated. |
+
+## timber\_force\_transients
+
+Filters whether to force a locked transients to be regenerated.
+
+**DEPRECATED** since 2.0.0, use `timber/transient/force_transients`
+
+If a transient is locked, it means that another process is currently generating the data.
+If you want to force the transient to be regenerated, during that process, you can set this
+filter to true.
+
+## timber/transient/force\_transient\_{$slug}
+
+Filters whether to force a specific locked transients to be regenerated.
+
+If a transient is locked, it means that another process is currently generating the data.
+If you want to force the transient to be regenerated during that process, you can set this value to true.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $force | `bool` | Whether to force a locked transient to be regenerated. |
+
+**PHP**
+
+```php
+
+add_filter( 'timber/transient/force_transient_mycustumslug', function($force) {
+    if(false == something_special_has_occurred()){
+      return false;
+    }
+
+    return true;
+}, 10 );
+```
+
+## timber\_force\_transient\_{$slug}
+
+Filters whether to force a specific locked transients to be regenerated.
+
+**DEPRECATED** since 2.0.0, use `timber/transient/force_transient_{$slug}`
+
+If a transient is locked, it means that another process is currently generating the data.
+If you want to force the transient to be regenerated, during that process, you can set this value to true.
+`$slug` The transient slug.
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $force | `bool` | Whether to force a locked transient to be regenerated. |
+
+## timber/helper/wp\_title\_separator
+
+Filters the separator used for the page title.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $separator | `string` | The separator to use. Default `' '`. |
+
+## timber\_wp\_title\_seperator
+
+Filters the separator used for the page title.
+
+**DEPRECATED** since 2.0.0, use `timber/helper/wp_title_separator`
+
+## timber/image/src
+
+Filters the src URL for a `Timber\Image`.
+
+**see** [Timber\Image::src()](/docs/reference/timber-image/#src)
+
+**since** 0.21.7
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $src | `string` | The image src. |
+| $id | `int` | The image ID. |
+
+## timber\_image\_src
+
+Filters the src URL for a `Timber\Image`.
+
+**DEPRECATED** since 2.0.0, use `timber/image/src`
+
+## timber/sideload\_image/basename
+
+Filters basename for sideloaded files.
+
+**since** 2.1.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $basename | `string` | Current basename for the sideloaded file. |
+| $path_parts | `array` | Array with path info for the sideloaded file. |
+
+**PHP**
+
+```php
+// Change the basename used for sideloaded images.
+add_filter( 'timber/sideload_image/basename', function ($basename, $path_parts) {
+    return $path_parts['filename'] . '-' . substr($basename, 0, 6);
+}, 10, 2)
+```
+
+## timber/sideload\_image/subdir
+
+Filters to directory that should be used for sideloaded images.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $subdir | `string` | The subdir name to use for sideloaded images. Return an empty string or a falsey value in order to not use a subfolder. Default `external`. |
+
+**PHP**
+
+```php
+// Change the subdirectory used for sideloaded images.
+add_filter( 'timber/sideload_image/subdir', function( $subdir ) {
+    return 'sideloaded';
+} );
+
+// Disable subdirectory used for sideloaded images.
+add_filter( 'timber/sideload_image/subdir', '__return_false' );
+```
+
+## timber/image\_helper/pre\_analyze\_url
+
+Filters whether to short-circuit the ImageHelper::analyze_url()
+file path of a URL located in a theme directory.
+
+Returning a non-null value from the filter will short-circuit
+ImageHelper::analyze_url(), returning that value.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $info | `array<string,mixed>` or `null` | The URL components array to short-circuit with. Default null. |
+| $url | `string` | The URL pointing to an image. |
+
+## timber/image\_helper/analyze\_url
+
+Filters the array of analyzed URL components.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $info | `array<string,mixed>` | The URL components. |
+| $url | `string` | The URL pointing to an image. |
+
+## timber/image\_helper/pre\_theme\_url\_to\_dir
+
+Filters whether to short-circuit the ImageHelper::theme_url_to_dir()
+file path of a URL located in a theme directory.
+
+Returning a non-null value from the filter will short-circuit
+ImageHelper::theme_url_to_dir(), returning that value.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $path | `string` or `null` | Full path to short-circuit with. Default null. |
+| $src | `string` | The URL to be converted. |
+
+## timber/image\_helper/theme\_url\_to\_dir
+
+Filters the raw file path of a URL located in a theme directory.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $path | `string` | The resolved full path to $src. |
+| $src | `string` | The URL that was converted. |
+
+## timber/image/new\_url
+
+Filters the URL for the resized version of a `Timber\Image`.
+
+You’ll probably need to use this in combination with `timber/image/new_path`.
+
+**since** 1.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $new_url | `string` | The URL to the resized version of an image. |
+
+## timber/image/new\_path
+
+Filters the destination path for the resized version of a `Timber\Image`.
+
+A possible use case for this would be to store all images generated by Timber in a
+separate directory. You’ll probably need to use this in combination with
+`timber/image/new_url`.
+
+**since** 1.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $destination_path | `string` | Full path to the destination of a resized image. |
+
+## timber/cache/mode
+
+Filters the cache mode.
+
+You can read more about Caching in the
+[Performance/Caching]({{<relref "performance.md" >}}) guide.
+
+**since** 0.20.10
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $cache_mode | `string` | The cache mode. Can be one of the following: `Timber\Loader::CACHE_NONE`, `Timber\Loader::CACHE_OBJECT`, `Timber\Loader::CACHE_TRANSIENT`, `Timber\Loader::CACHE_SITE_TRANSIENT`, `Timber\Loader::CACHE_USE_DEFAULT`. Default `Timber\Loader::CACHE_TRANSIENT`. |
+
+## timber\_cache\_mode
+
+Filters the cache mode.
+
+**DEPRECATED** since 2.0.0, use `timber/cache/mode`
+
+## timber/loader/render\_data
+
+Filters …
+
+**since** 0.20.10
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $data | `array` |  |
+| $file | `string` |  |
+
+## timber\_loader\_render\_data
+
+Filters …
+
+**DEPRECATED** since 2.0.0, use `timber/loader/render_data`
+
+## timber/output/pre-cache
+
+Filters $output before it is cached.
+
+**since** 2.1.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $output | `string` |  |
+| $data | `array` |  |
+| $file | `string` |  |
+
+## timber/output
+
+Filters …
+
+**since** 0.20.10
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $output | `string` |  |
+| $data | `array` |  |
+| $file | `string` |  |
+
+## timber\_output
+
+Filters …
+
+**DEPRECATED** since 2.0.0, use `timber/output`
+
+## timber/loader/paths
+
+Filters the template paths used by the Loader.
+
+**DEPRECATED** since 2.0.0, use `timber/locations`
+
+**since** 0.20.10
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $paths | `array` |  |
+
+## timber/loader/loader
+
+Filters …
+
+**link** <https://github.com/timber/timber/pull/1254>
+
+**since** 1.1.11
+
+## timber/twig/environment/options
+
+Filters the environment options that are used when creating a Twig Environment instance.
+
+By default, Timber sets the following values:
+
+- `'debug' => WP_DEBUG`
+- `'autoescape' => false`
+- `'cache' => false`
+
+**link** <https://twig.symfony.com/doc/2.x/api.html#environment-options>
+
+**since** 1.9.5
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $environment_options | `array` | An array of Twig environment options. |
+
+**PHP**
+
+```php
+add_filter( 'timber/twig/environment/options', 'update_twig_environment_options' );
+
+/**
+ * Updates Twig environment options.
+ *
+ * @link https://twig.symfony.com/doc/2.x/api.html#environment-options
+ *
+ * \@param array $options An array of environment options.
+ *
+ * @return array
+ */
+function update_twig_environment_options( $options ) {
+    $options['cache']       = true;
+    $options['auto_reload'] = true;
+
+    return $options;
+}
+```
+
+## timber/cache/location
+
+Filters the cache location used for Twig.
+
+**DEPRECATED** since 2.0.0
+
+Allows you to set a new cache location for Twig. If the folder doesn’t exist yet, it
+will be created automatically.
+
+**since** 0.20.10
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $twig_cache_loc | `string` | Full path to the cache location. Default `/cache/twig` in the Timber root folder. |
+
+## timber/cache/enable\_extension
+
+Filters the cache extension activation.
+
+Allows users to disable the cache extension and use their own
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $enable_cache_extension | `bool` | Whether to enable the cache extension. |
+
+## timber/loader/twig
+
+Filters …
+
+**since** 0.20.10
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $twig | `\Environment` | The Twig environment you can add functionality to. |
+
+## timber/twig
+
+Filters the Twig environment used in the global context.
+
+You can use this filter if you want to add additional functionality to Twig, like global
+variables, filters or functions.
+
+**since** 0.21.9
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $twig | `\Environment` | The Twig environment. |
+
+**PHP**
+
+```php
+/**
+ * Adds Twig functionality.
+ *
+ * \@param \Twig\Environment $twig The Twig Environment to which you can add additional functionality.
+ */
+add_filter( 'timber/twig', function( $twig ) {
+    // Make get_theme_file_uri() usable as {{ theme_file() }} in Twig.
+    $twig->addFunction( new Twig\TwigFunction( 'theme_file', 'get_theme_file_uri' ) );
+
+    return $twig;
+} );
+```
+
+**Twig**
+
+```twig
+<a class="navbar-brand" href="{{ site.url }}">
+    <img src="{{ theme_file( 'build/img/logo-example.svg' ) }}" alt="Logo {{ site.title }}">
+</a>
+```
+
+## timber/cache/extension/lifetime
+
+Filters the Twig environment used in the global context.
+
+**DEPRECATED** since 2.0.0
+
+## timber/cache/transient\_key
+
+Filters the transient key used for caching.
+
+**since** 2.1.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $trans_key | `string` | The transient key. |
+| $key | `string` | The cache key. |
+| $group | `string` | The cache group. |
+| $cache_mode | `string` | The cache mode. |
+
+```
+add_filter( 'timber/cache/transient_key', function( $trans_key, $key, $group, $cache_mode ) {
+    return $trans_key . '_my_suffix';
+}, 10, 4 );
+```
+
+## timber/cache/transient\_key
+
+Filters the transient key used for caching.
+
+**since** 2.1.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $trans_key | `string` | The transient key. |
+| $key | `string` | The cache key. |
+| $group | `string` | The cache group. |
+| $cache_mode | `string` | The cache mode. |
+
+```
+add_filter( 'timber/cache/transient_key', function( $trans_key, $key, $group, $cache_mode ) {
+    return $trans_key . '_my_suffix';
+}, 10, 4 );
+```
+
+## timber/locations
+
+Filters the filesystem paths to search for Twig templates.
+
+**since** 0.20.10
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $locs | `array` | An array of filesystem paths to search for Twig templates. |
+
+```
+add_filter( 'timber/locations', function( $locs ) {
+  $locs = \array_map(function ($loc) {
+     \array_unshift($loc, \dirname(__DIR__) . '/my-custom-dir');
+      return $loc;
+  }, $locs);
+
+    return $locs;
+} );
+```
+
+## timber\_locations
+
+Filters the filesystem paths to search for Twig templates.
+
+**DEPRECATED** since 2.0.0, use `timber/locations`
+
+## timber/menu/item\_objects
+
+Filters the sorted list of menu item objects before creating the Menu object.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $item | `array` |  |
+| $menu | `\WP_Term` |  |
+
+```
+add_filter( 'timber/menu/item_objects', function ( $items ) {
+    return array_map(function ($item) {
+        if ( is_object( $item ) && ! ( $item instanceof \WP_Post ) ) {
+            return new \WP_Post( get_object_vars( $item ) );
+        }
+
+        return $item;
+    }, $items);
+} );
+```
+
+## timber/post/import\_data
+
+Filters the imported post data.
+
+Used internally for previews.
+
+**see** Timber::init()
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $data | `array` | An array of post data to import. |
+| $post | `\Post` | The Timber post instance. |
+
+## timber/post/meta\_object\_field
+
+Filters field object data from Advanced Custom Fields.
+
+This filter is used by the ACF Integration.
+
+**see** [Timber\Post::field_object()](/docs/reference/timber-post/#field_object)
+
+**since** 1.6.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $value | `mixed` | The value. |
+| $post_id | `int` or `null` | The post ID. |
+| $field_name | `string` | The ACF field name. |
+| $post | `\Post` | The post object. |
+
+## timber/post/authors
+
+Filters authors for a post.
+
+This filter is used by the CoAuthorsPlus integration.
+
+**see** [Timber\Post::authors()](/docs/reference/timber-post/#authors)
+
+**since** 1.1.4
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $authors | `array` | An array of User objects. Default: User object for `post_author`. |
+| $post | `\Post` | The post object. |
+
+```
+add_filter( 'timber/post/authors', function( $author, $post ) {
+     foreach ($cauthors as $author) {
+       // do something with $author
+     }
+
+    return $authors;
+} );
+```
+
+## timber/post/children\_args
+
+Filters the arguments for the query used to get the children of a post.
+
+This filter is used by the `Timber\Post::children()` method. It allows you to modify the
+arguments for the `get_children` function. This way you can change the query to get the
+children of a post.
+
+**see** [Timber\Post::children()](/docs/reference/timber-post/#children)
+
+**since** 2.1.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $arguments | `array` | An array of arguments for the `get_children` function. |
+| $post | `\Post` | The post object. |
+
+```
+add_filter( 'timber/post/children_args', function( $args, $post ) {
+
+    if ( $post->post_type === 'custom_post_type' ) {
+       $args['post_status'] = 'private';
+    }
+
+    return $args;
+} );
+```
+
+## timber/post/content/show\_password\_form\_for\_protected
+
+Filters whether the password form should be shown for password protected posts.
+
+This filter runs only when you call `{{ post.content }}` for a password protected
+post. When this filter returns `true`, a password form will be shown instead of the
+post content. If you want to modify the form itself, you can use the
+`timber/post/content/password_form` filter.
+
+**since** 1.1.4
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $show_pw | `bool` | Whether the password form should be shown. Default `false`. |
+
+**PHP**
+
+```php
+// Always show password form for password protected posts.
+add_filter( 'timber/post/content/show_password_form_for_protected', '__return_true' );
+```
+
+## timber/post/content/password\_form
+
+Filters the password form output.
+
+As an alternative to this filter, you could also use WordPress’s `the_password_form` filter.
+The difference to this filter is, that you’ll also have the post object available as a second
+parameter, in case you need that.
+
+**since** 1.1.4
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $form | `string` | Form output. Default WordPress password form output generated by `get_the_password_form()`. |
+| $post | `\Post` | The post object. |
+
+**PHP**
+
+```php
+// Modify the password form.
+add_filter( 'timber/post/content/password_form', function( $form, $post ) {
+    return Timber::compile( 'assets/password-form.twig', array( 'post' => $post ) );
+}, 10, 2 );
+```
+
+## timber/post/content/remove\_blocks
+
+Filters whether the content produced by block editor blocks should be removed or not from the content.
+
+If truthy then block whose content does not belong in the excerpt, will be removed.
+This removal is done using WordPress Core `excerpt_remove_blocks` function.
+
+**see** excerpt_remove_blocks() The WordPress Core function that will handle the block removal from the excerpt.
+
+**since** 2.1.1
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $remove_blocks | `bool` | Whether blocks whose content should not be part of the excerpt should be removed or not from the excerpt. |
+
+## timber/post/excerpt/defaults
+
+Filters the default options used for post excerpts.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $defaults | `array` | An array of default options. You can see which options you can use  when you look at the `$options` parameter for [PostExcerpt::__construct()](https://timber.github.io/docs/v2/reference/timber-postexcerpt/#__construct). |
+
+**PHP**
+
+```php
+add_filter( 'timber/post/excerpt/defaults', function( $defaults ) {
+    // Only add a read more link if the post content isn’t longer than the excerpt.
+    $defaults['always_add_read_more'] = false;
+
+    // Set a default character limit.
+    $defaults['words'] = 240;
+
+    return $defaults;
+} );
+```
+
+## timber/post/excerpt/read\_more\_class
+
+Filters the CSS class used for excerpt links.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $class | `string` | The CSS class to use for the excerpt link. Default `read-more`. |
+
+**PHP**
+
+```php
+// Change the CSS class for excerpt links.
+add_filter( 'timber/post/excerpt/read_more_class', function( $class ) {
+    return 'read-more__link';
+} );
+```
+
+## timber/post/preview/read\_more\_class
+
+Filters the CSS class used for excerpt links.
+
+**DEPRECATED** since 2.0.0
+
+**since** 1.0.4
+
+## timber/post/excerpt/read\_more\_link
+
+Filters the link used for a read more text in an excerpt.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $link | `string` | The HTML link. |
+| $post | `\Post` | Post instance. |
+| $linktext | `string` | The link text. |
+| $read_more_class | `string` | The CSS class name. |
+
+## timber/post/get\_preview/read\_more\_link
+
+Filters the link used for a read more text in an excerpt.
+
+**DEPRECATED** since 2.0.0
+
+**since** 1.1.3
+
+## timber/site/update\_option
+
+Filters a value before it is updated in the site options.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $value | `mixed` | The new value. |
+| $key | `string` | The option key. |
+| $site_id | `int` | The site ID. |
+| $site | `\Site` | The site object. |
+
+## timber\_site\_set\_meta
+
+Filters a value before it is updated in the site options.
+
+**DEPRECATED** since 2.0.0, use `timber/site/update_option`
+
+**since** 0.20.0
+
+## timber/term/link
+
+Filters the link to the term archive page.
+
+**see** [Timber\Term::link()](/docs/reference/timber-term/#link)
+
+**since** 0.21.9
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $link | `string` | The link. |
+| $term | `\Term` | The term object. |
+
+## timber\_term\_link
+
+Filters the link to the term archive page.
+
+**DEPRECATED** since 0.21.9, use `timber/term/link`
+
+## timber/term/path
+
+Filters the relative link (path) to a term archive page.
+
+```
+add_filter( 'timber/term/path', function( $rel, $term ) {
+    if ( $term->slug === 'news' ) {
+       return '/category/modified-url';
+    }
+
+    return $rel;
+}, 10, 2 );
+```
+
+**see** [Timber\Term::path()](/docs/reference/timber-term/#path)
+
+**since** 0.21.9
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $rel | `string` | The relative link. |
+| $term | `\Term` | The term object. |
+
+## timber\_term\_path
+
+Filters the relative link (path) to a term archive page.
+
+**DEPRECATED** since 2.0.0, use `timber/term/path`
+
+## timber\_term\_set\_meta
+
+Filters term meta value that is going to be updated.
+
+**DEPRECATED** since 2.0.0 with no replacement
+
+## timber/term/meta/set
+
+Filters term meta value that is going to be updated.
+
+**DEPRECATED** since 2.0.0, with no replacement
+
+This filter is used by the ACF Integration.
+
+## timber/trim\_words/allowed\_tags
+
+Filters allowed tags for `trim_words()` helper.
+
+The `trim_words()` helper strips all HTML tags from a text it trims, except for a list of
+allowed tags. Instead of passing the allowed tags every time you use `trim_words()` (or `{{ text|truncate }}`
+in Twig), you can use this filter to set the allowed tags.
+
+**see** [Timber\TextHelper::trim_words()](/docs/reference/timber-texthelper/#trim_words)
+
+**since** 0.21.9
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $allowed_tags | `string` | Allowed tags, separated by one whitespace. Default `p a span b i br blockquote`. |
+
+## timber/integrations
+
+Filters the integrations that should be initialized by Timber.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $integrations | `\IntegrationInterface[]` | An array of PHP class names. Default: array of integrations that Timber initializes by default. |
+
+## timber/context
+
+Filters the global Timber context.
+
+By using this filter, you can add custom data to the global Timber context, which
+means that this data will be available on every page that is initialized with
+`Timber::context()`.
+
+Be aware that data will be cached as soon as you call `Timber::context()` for the
+first time. That’s why you should add this filter before you call
+`Timber::context()`.
+
+**see** [Timber\Timber::context()](/docs/reference/timber-timber/#context)
+
+**since** 0.21.7
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $context | `array` | The global context. |
+
+**PHP**
+
+```php
+add_filter( 'timber/context', function( $context ) {
+    // Example: A custom value
+    $context['custom_site_value'] = 'Hooray!';
+
+    // Example: Add a menu to the global context.
+    $context['menu'] = new \Timber\Menu( 'primary-menu' );
+
+    // Example: Add all ACF options to global context.
+    $context['options'] = get_fields( 'options' );
+
+    return $context;
+} );
+```
+**Twig**
+
+```twig
+<h1>{{ custom_site_value|e }}</h1>
+
+{% for item in menu.items %}
+    {# Display menu item #}
+{% endfor %}
+
+<footer>
+    {% if options.footer_text is not empty %}
+        {{ options.footer_text|e }}
+    {% endif %}
+</footer>
+```
+
+## timber\_context
+
+Filters the global Timber context.
+
+**DEPRECATED** since 2.0.0, use `timber/context`
+
+## timber/render/file
+
+Filters the Twig template that should be rendered.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $file | `string` | The chosen Twig template name to render. |
+
+## timber\_render\_file
+
+Filters the Twig file that should be rendered.
+
+**DEPRECATED** since 2.0.0, use `timber/render/file`
+
+## timber/compile/file
+
+Filters the Twig template that should be compiled.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $file | `string` | The chosen Twig template name to compile. |
+
+## timber\_compile\_file
+
+Filters the Twig template that should be compiled.
+
+**DEPRECATED** since 2.0.0
+
+## timber/render/data
+
+Filters the data that should be passed for rendering a Twig template.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $data | `array` | The data that is used to render the Twig template. |
+| $file | `string` | The name of the Twig template to render. |
+
+## timber\_render\_data
+
+Filters the data that should be passed for rendering a Twig template.
+
+**DEPRECATED** since 2.0.0
+
+## timber/compile/data
+
+Filters the data that should be passed for compiling a Twig template.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $data | `array` | The data that is used to compile the Twig template. |
+| $file | `string` | The name of the Twig template to compile. |
+
+## timber\_compile\_data
+
+Filters the data that should be passed for compiling a Twig template.
+
+**DEPRECATED** since 2.0.0, use `timber/compile/data`
+
+## timber/compile/result
+
+Filters the compiled result before it is returned in `Timber::compile()`.
+
+It adds the possibility to filter the output ready for render.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $output | `string` or `bool` | the compiled output. |
+
+## timber\_compile\_result
+
+Filters the compiled result before it is returned.
+
+**DEPRECATED** since 2.0.0 use timber/compile/result
+
+**see** [Timber\Timber::fetch()](/docs/reference/timber-timber/#fetch)
+
+**since** 0.16.7
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $output | `string` | The compiled output. |
+
+## timber/twig/functions
+
+Filters the functions that are added to Twig.
+
+The `$functions` array is an associative array with the filter name as a key and an
+arguments array as the value. In the arguments array, you pass the function to call with
+a `callable` entry.
+
+This is an alternative filter that you can use instead of adding your function in the
+`timber/twig` filter.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $functions | `array` |  |
+
+**PHP**
+
+```php
+add_filter( 'timber/twig/functions', function( $functions ) {
+    // Add your own function.
+    $functions['url_to_domain'] = [
+        'callable' => 'url_to_domain',
+    ];
+
+    // Replace a function.
+    $functions['get_image'] = [
+        'callable' => 'custom_image_get',
+    ];
+
+    // Remove a function.
+    unset( $functions['bloginfo'] );
+
+    return $functions;
+} );
+```
+
+## timber/twig/filters
+
+Filters the filters that are added to Twig.
+
+The `$filters` array is an associative array with the filter name as a key and an
+arguments array as the value. In the arguments array, you pass the function to call with
+a `callable` entry.
+
+This is an alternative filter that you can use instead of adding your filter in the
+`timber/twig` filter.
+
+**since** 2.0.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $filters | `array` |  |
+
+**PHP**
+
+```php
+add_filter( 'timber/twig/default_filters', function( $filters ) {
+    // Add your own filter.
+    $filters['price'] = [
+        'callable' => 'format_price',
+    ];
+
+    // Replace a filter.
+    $filters['list'] = [
+        'callable' => 'custom_list_filter',
+    ];
+
+    // Remove a filter.
+    unset( $filters['list'] );
+
+    return $filters;
+} );
+```
+
+## timber/twig/escapers
+
+Filters the escaping filters that are added to Twig.
+
+The `$escaper_filters` array is an associative array with the filter name as a key and an
+arguments array as the value. In the arguments array, you pass the function to call with
+a `callable` entry.
+
+**since** 2.1.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $escaper_filters | `array` |  |
+
+**PHP**
+
+```php
+add_filter( 'timber/twig/escapers', function( $escaper_filters ) {
+    // Add your own filter.
+    $filters['esc_xml'] = [
+        'callable' => 'esc_xml',
+         'options' => [
+            'is_safe' => ['html'],
+         ],
+    ];
+
+    // Remove a filter.
+    unset( $filters['esc_js'] );
+
+    return $filters;
+} );
+```
+
+## timber/url\_helper/url\_to\_file\_system/path
+
+Filters the path of a parsed URL.
+
+You can use this filter to alter the returned file system path.
+This filter is used by the WPML integration.
+
+**see** [Timber\URLHelper::url_to_file_system()](/docs/reference/timber-urlhelper/#url_to_file_system)
+
+**since** 1.3.2
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $path | `string` | The current translated path |
+
+## timber/URLHelper/url\_to\_file\_system/path
+
+Filters the path of a parsed URL.
+
+**DEPRECATED** since 2.0.0, use `timber/url_helper/url_to_file_system/path`
+
+## timber/url\_helper/file\_system\_to\_url
+
+Filters the URL in URLHelper::file_system_to_url
+
+You can use this filter to alter the returned URL.
+This filter is used by the WPML integration.
+
+**see** [Timber\URLHelper::file_system_to_url()](/docs/reference/timber-urlhelper/#file_system_to_url)
+
+**since** 1.3.2
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $url | `string` | The current translated url |
+
+## timber/URLHelper/file\_system\_to\_url
+
+Filters the URL in URLHelper::file_system_to_url
+
+**DEPRECATED** since 2.0.0, use `timber/url_helper/file_system_to_url`
+
+You can use this filter to alter the returned URL.
+This filter is used by the WPML integration.
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $url | `string` | The current url |
+
+## timber/url\_helper/get\_content\_subdir/home\_url
+
+Filters the home URL that is used to get the path relative to the content directory.
+
+**since** 1.3.2
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $home_url | `string` | The URL to use as the base for getting the content subdirectory. Default value of `home_url()`. |
+
+## timber/URLHelper/get\_content\_subdir/home\_url
+
+Filters the home URL that is used to get the path relative to the content directory.
+
+**DEPRECATED** since 2.0.0, use `timber/url_helper/get_content_subdir/home_url`
+
+## timber/url/schemes-whitelist
+
+Filters the schemes that are excluded for double slash removal.
+
+If an url start with one of the schemes in the whitelist,
+that scheme will be excluded from the double slash removal.
+
+**since** 1.16.0
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $schemes_whitelist | `array` | the schemes that are excluded for double slash removal. |
+
+## timber/user/name
+
+Filters the name of a user.
+
+**since** 1.1.4
+
+| Name | Type | Description |
+| --- | --- | --- |
+| $name | `string` | The name of the user. Default `display_name`. |
+| $user | `\User` | The user object. |
+
diff --git a/content/v2/reference/timber-texthelper.md b/content/v2/reference/timber-texthelper.md
index 60ea0d1a..11dbd92e 100644
--- a/content/v2/reference/timber-texthelper.md
+++ b/content/v2/reference/timber-texthelper.md
@@ -70,7 +70,7 @@ take the same amount of space in each post for example
 
 | Name | Type | Description |
 | --- | --- | --- |
-| $string |  |  |
+| $string | `mixed` |  |
 | $tags | `array` |  |
 
 ---
diff --git a/docs/sitemap.xml b/docs/sitemap.xml
index 6146fae1..4dfc1e79 100644
--- a/docs/sitemap.xml
+++ b/docs/sitemap.xml
@@ -2,514 +2,514 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
             <url>
                 <loc>https://timber.github.io/docs/404.html</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/_index/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/installation/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/getting-started/setup/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/getting-started/setup/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/getting-started/switch-to-composer/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/getting-started/theming/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/getting-started/twig-tools/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/getting-started/video-tutorials/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/acf-cookbook/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/cheatsheet/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/comments/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/cookbook-images/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/cookbook-text/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/cookbook-twig/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/custom-page-templates/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/debugging/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/escapers/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/extending-timber/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/filters/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/functions/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/gutenberg/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/hosts-servers/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/internationalization/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/menus/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/pagination/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/performance/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/routing/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/sidebars/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/template-locations/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/testing/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/woocommerce/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/guides/wp-integration/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/reference/timber-archives/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/reference/timber-comment/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/reference/timber-helper/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/reference/timber-image/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/reference/timber-imagehelper/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/reference/timber-menu/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/reference/timber-menuitem/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/reference/timber-pagination/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/reference/timber-post/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/reference/timber-postpreview/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/reference/timber-postquery/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/reference/timber-site/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/reference/timber-term/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/reference/timber-texthelper/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/reference/timber-theme/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/reference/timber-urlhelper/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/reference/timber-user/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/reference/timber/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v1/upgrade-guides/1.0/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/getting-started/a-post-archive/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/getting-started/a-single-post/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/getting-started/introduction/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/getting-started/template-inheritance-and-includes/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/cheatsheet/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/class-maps/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/comments/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/context/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/cookbook-images/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/cookbook-text/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/custom-fields/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/custom-integrations/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/custom-page-templates/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/date-time/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/debugging/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/escaping/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/extending-timber/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/extending-twig/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/functions/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/gutenberg/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/hosts-servers/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/internationalization/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/menus/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/pagination/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/performance/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/posts/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/routing/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/shortcodes/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/sidebars/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/template-locations/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/terms/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/testing/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/twig-filters/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/twig/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/users/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/widgets/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/woocommerce/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/guides/wp-cli/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/installation/installation/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/installation/intro-to-composer/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/installation/manage-timber-with-composer/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/integrations/advanced-custom-fields/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/upgrade-guides/1.0/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/upgrade-guides/2.0/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/contributing/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-archives/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-attachment/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-cache-cleaner/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-comment/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-datetimehelper/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-externalimage/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-helper/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-image/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-imagedimensions/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-imagehelper/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-menu/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-menuitem/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-pagesmenu/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-pagination/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-pathhelper/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-post/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-postarrayobject/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-postexcerpt/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-postquery/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-site/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-term/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-texthelper/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-theme/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-timber/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-urlhelper/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/reference/timber-user/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/hooks/filters/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
             <url>
                 <loc>https://timber.github.io/docs/v2/hooks/actions/</loc>
-                <lastmod>2024-05-15</lastmod>
+                <lastmod>2024-06-07</lastmod>
             </url>
 </urlset>
diff --git a/docs/v2/hooks/actions/index.html b/docs/v2/hooks/actions/index.html
index 25c9cb8b..200f4f01 100644
--- a/docs/v2/hooks/actions/index.html
+++ b/docs/v2/hooks/actions/index.html
@@ -2,7 +2,7 @@
 	  function gtag(){dataLayer.push(arguments);}
 	  gtag('js', new Date());
 
-	  gtag('config', 'UA-126807198-1');</script><title>Action Hooks – Timber v2 – Timber Documentation</title><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta http-equiv="x-ua-compatible" content="ie=edge"><meta name="docsearch:version" content="v2"><link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@docsearch/css@3"><link rel="stylesheet" href="/docs/build/css/styles.css?id=c9d85857d742479204d190fd66fabaf1"><link rel="stylesheet" href="/docs/build/css/mobile.css?id=eb03f5e9c806ca82b2fc8d728401461a" media="screen and (max-width: 979px)"><script src="/docs/build/js/app.js?id=4594e1490acc2ce9d471fb2243cbcfce" defer="defer"></script><link rel="icon" href="/docs/build/favicons/favicon.ico" type="image/x-icon"><link rel="apple-touch-icon-precomposed" sizes="57x57" href="/docs/build/favicons/apple-touch-icon-57x57.png"><link rel="apple-touch-icon-precomposed" sizes="114x114" href="/docs/build/favicons/apple-touch-icon-114x114.png"><link rel="apple-touch-icon-precomposed" sizes="72x72" href="/docs/build/favicons/apple-touch-icon-72x72.png"><link rel="apple-touch-icon-precomposed" sizes="144x144" href="/docs/build/favicons/apple-touch-icon-144x144.png"><link rel="apple-touch-icon-precomposed" sizes="60x60" href="/docs/build/favicons/apple-touch-icon-60x60.png"><link rel="apple-touch-icon-precomposed" sizes="120x120" href="/docs/build/favicons/apple-touch-icon-120x120.png"><link rel="apple-touch-icon-precomposed" sizes="76x76" href="favicons/apple-touch-icon-76x76.png"><link rel="apple-touch-icon-precomposed" sizes="152x152" href="favicons/apple-touch-icon-152x152.png"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-196x196.png" sizes="196x196"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-96x96.png" sizes="96x96"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-32x32.png" sizes="32x32"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-16x16.png" sizes="16x16"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-128.png" sizes="128x128"><meta name="application-name" content="Timber Documentation"><meta name="msapplication-TileColor" content="#FFFFFF"><meta name="msapplication-TileImage" content="/docs/build/favicons/mstile-144x144.png"><meta name="msapplication-square70x70logo" content="/docs/build/favicons/mstile-70x70.png"><meta name="msapplication-square150x150logo" content="/docs/build/favicons/mstile-150x150.png"><meta name="msapplication-wide310x150logo" content="/docs/build/favicons/mstile-310x150.png"><meta name="msapplication-square310x310logo" content="/docs/build/favicons/mstile-310x310.png"><meta name="twitter:card" content="summary_large_image"><meta name="twitter:site" content="@TimberWP"><meta name="twitter:title" content="Timber for WordPress Documentation"><meta name="twitter:description" content="Create WordPress themes with beautiful OOP code and the Twig Template Engine"><meta name="twitter:image" content="https://repository-images.githubusercontent.com/7413451/06c62480-b95c-11ea-8b35-b5dd97d070f1"></head><body><header class="header"><div class="logoContainer"><a href="/docs/"><img src="/docs/build/img/timber-logo.svg" alt="Timber Logo" style="width: 105px; height: 30px; border: 0" role="img"></a></div><div class="search"><div id="docsearch"></div></div><nav class="navTop" id="nav-top"><ul><li><a href="https://upstatement.com/timber/" target="_blank" rel="noreferrer noopener">About Timber</a></li><li><a href="https://twig.symfony.com/doc/" target="_blank" rel="noreferrer noopener">Twig Docs</a></li><li><a href="https://opencollective.com/timber" target="_blank" rel="noreferrer noopener">Sponsor us</a></li><li><a href="https://github.com/timber/timber" target="_blank" rel="noreferrer noopener"><img src="/docs/build/img/github.png" alt="Star on Github" style="width: 29px; height: 29px; border: 0"></a></li></ul></nav><button class="navMobileToggle js-menu-open" type="button" id="nav-mobile-toggle"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 34"><path d="M45.6,19.43H2.4a2.43,2.43,0,0,1,0-4.86H45.6a2.43,2.43,0,0,1,0,4.86Z"/><path d="M45.6,4.86H2.4A2.41,2.41,0,0,1,0,2.43,2.41,2.41,0,0,1,2.4,0H45.6A2.41,2.41,0,0,1,48,2.43,2.41,2.41,0,0,1,45.6,4.86Z"/><path d="M45.6,34H2.4a2.43,2.43,0,0,1,0-4.86H45.6a2.43,2.43,0,0,1,0,4.86Z"/></svg> <span class="sr-only">Menu</span></button></header><div class="wrapper"><aside class="sidebar slideup-menu" id="sidebar" data-turbolinks-keep-scroll-position><button class="navClose js-menu-close" type="button"><div class="navClose-icon" aria-hidden="true"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48"><path d="M3.43,48A3.43,3.43,0,0,1,1,42.15L42.15,1A3.43,3.43,0,1,1,47,5.85L5.85,47A3.4,3.4,0,0,1,3.43,48Z"/><path d="M44.57,48a3.4,3.4,0,0,1-2.42-1L1,5.85A3.43,3.43,0,0,1,5.85,1L47,42.15A3.43,3.43,0,0,1,44.57,48Z"/></svg></div><span class="sr-only">Close Menu</span></button><nav class="navVersions"><ul><li><a href="/docs/v2/" class="is-current">v2.x</a></li><li><a href="/docs/v1/">v1.x</a></li></ul></nav><nav id="nav-main" class="navMain"><ul class="navMain-sections"><li class="navMain-section"><h3 class="navMain-title">Installation</h3><ul class="navMain-items"><li class="navMain-item" data-order="10"><a class="navMain-link" href="/docs/v2/installation/installation/">Installation</a></li><li class="navMain-item" data-order="30"><a class="navMain-link" href="/docs/v2/installation/manage-timber-with-composer/">Managing Timber with Composer</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Getting Started</h3><ul class="navMain-items"><li class="navMain-item" data-order="100"><a class="navMain-link" href="/docs/v2/getting-started/introduction/">Introduction</a></li><li class="navMain-item" data-order="200"><a class="navMain-link" href="/docs/v2/getting-started/template-inheritance-and-includes/">Template inheritance and includes</a></li><li class="navMain-item" data-order="300"><a class="navMain-link" href="/docs/v2/getting-started/a-single-post/">A single post</a></li><li class="navMain-item" data-order="400"><a class="navMain-link" href="/docs/v2/getting-started/a-post-archive/">A post archive</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Guides</h3><ul class="navMain-items"><li class="navMain-item" data-order="50"><a class="navMain-link" href="/docs/v2/guides/context/">Context</a></li><li class="navMain-item" data-order="75"><a class="navMain-link" href="/docs/v2/guides/template-locations/">Template Locations</a></li><li class="navMain-item" data-order="110"><a class="navMain-link" href="/docs/v2/guides/posts/">Posts</a></li><li class="navMain-item" data-order="120"><a class="navMain-link" href="/docs/v2/guides/terms/">Terms</a></li><li class="navMain-item" data-order="130"><a class="navMain-link" href="/docs/v2/guides/users/">Users</a></li><li class="navMain-item" data-order="140"><a class="navMain-link" href="/docs/v2/guides/comments/">Comments</a></li><li class="navMain-item" data-order="150"><a class="navMain-link" href="/docs/v2/guides/menus/">Menus</a></li><li class="navMain-item" data-order="160"><a class="navMain-link" href="/docs/v2/guides/widgets/">Widgets</a></li><li class="navMain-item" data-order="170"><a class="navMain-link" href="/docs/v2/guides/shortcodes/">Shortcodes</a></li><li class="navMain-item" data-order="200"><a class="navMain-link" href="/docs/v2/guides/twig/">Twig</a></li><li class="navMain-item" data-order="220"><a class="navMain-link" href="/docs/v2/guides/twig-filters/">Twig filters</a></li><li class="navMain-item" data-order="300"><a class="navMain-link" href="/docs/v2/guides/cookbook-text/">Text Cookbook</a></li><li class="navMain-item" data-order="400"><a class="navMain-link" href="/docs/v2/guides/escaping/">Escaping</a></li><li class="navMain-item" data-order="500"><a class="navMain-link" href="/docs/v2/guides/custom-page-templates/">Custom Page Templates</a></li><li class="navMain-item" data-order="600"><a class="navMain-link" href="/docs/v2/guides/custom-fields/">Custom Fields</a></li><li class="navMain-item" data-order="800"><a class="navMain-link" href="/docs/v2/guides/functions/">Functions</a></li><li class="navMain-item" data-order="1000"><a class="navMain-link" href="/docs/v2/guides/cookbook-images/">Image Cookbook</a></li><li class="navMain-item" data-order="1100"><a class="navMain-link" href="/docs/v2/guides/pagination/">Pagination</a></li><li class="navMain-item" data-order="1200"><a class="navMain-link" href="/docs/v2/guides/sidebars/">Sidebars</a></li><li class="navMain-item" data-order="1300"><a class="navMain-link" href="/docs/v2/guides/performance/">Performance/Caching</a></li><li class="navMain-item" data-order="1350"><a class="navMain-link" href="/docs/v2/guides/date-time/">Date/Time in Timber</a></li><li class="navMain-item" data-order="1400"><a class="navMain-link" href="/docs/v2/guides/internationalization/">Internationalization</a></li><li class="navMain-item" data-order="1500"><a class="navMain-link" href="/docs/v2/guides/cheatsheet/">Cheatsheet</a></li><li class="navMain-item" data-order="1550"><a class="navMain-link" href="/docs/v2/guides/gutenberg/">Block Editor (Gutenberg)</a></li><li class="navMain-item" data-order="1600"><a class="navMain-link" href="/docs/v2/guides/extending-timber/">Extending Timber</a></li><li class="navMain-item" data-order="1650"><a class="navMain-link" href="/docs/v2/guides/extending-twig/">Extending Twig</a></li><li class="navMain-item" data-order="1660"><a class="navMain-link" href="/docs/v2/guides/class-maps/">Class Maps</a></li><li class="navMain-item" data-order="1670"><a class="navMain-link" href="/docs/v2/guides/wp-cli/">WP-CLI</a></li><li class="navMain-item" data-order="1700"><a class="navMain-link" href="/docs/v2/guides/hosts-servers/">Hosts &amp; Servers</a></li><li class="navMain-item" data-order="1800"><a class="navMain-link" href="/docs/v2/guides/debugging/">Debugging</a></li><li class="navMain-item" data-order="1900"><a class="navMain-link" href="/docs/v2/guides/testing/">Automated Testing</a></li><li class="navMain-item" data-order="2000"><a class="navMain-link" href="/docs/v2/guides/routing/">Routing</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/guides/custom-integrations/">Custom Integrations</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/guides/woocommerce/">WooCommerce</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Reference</h3><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-archives/">Archives</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-attachment/">Attachment</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-cache-cleaner/">Cleaner</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-comment/">Comment</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-datetimehelper/">DateTimeHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-externalimage/">ExternalImage</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-helper/">Helper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-image/">Image</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-imagedimensions/">ImageDimensions</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-imagehelper/">ImageHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-menu/">Menu</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-menuitem/">MenuItem</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-pagesmenu/">PagesMenu</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-pagination/">Pagination</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-pathhelper/">PathHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-post/">Post</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-postarrayobject/">PostArrayObject</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-postexcerpt/">PostExcerpt</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-postquery/">PostQuery</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-site/">Site</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-term/">Term</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-texthelper/">TextHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-theme/">Theme</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-timber/">Timber</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-urlhelper/">URLHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-user/">User</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title navMain-sectionTitle">Hooks</h3><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/hooks/actions/" aria-current>Action Hooks</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/hooks/filters/">Filter Hooks</a></li></ul></li><li class="navMain-section"><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/integrations/advanced-custom-fields/">Advanced Custom Fields</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Upgrade Guides</h3><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/upgrade-guides/1.0/">Upgrade to 1.0</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/upgrade-guides/2.0/">Upgrade to 2.0</a></li></ul></li><li class="navMain-section"><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/contributing/">Contributing to Timber</a></li></ul></li></ul></nav></aside><div class="main-container"><div class="version-note"><p>You are reading the documentation for <strong>Timber v2.x</strong>. Switch to the documentation for Timber <a href="/docs/v1/">v1.x</a>.</p></div><main><article><h1>Action Hooks</h1><div class="content"></div></article></main></div></div><script src="https://cdn.jsdelivr.net/npm/@docsearch/js@3"></script><script>docsearch({
+	  gtag('config', 'UA-126807198-1');</script><title>Action Hooks – Timber v2 – Timber Documentation</title><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta http-equiv="x-ua-compatible" content="ie=edge"><meta name="docsearch:version" content="v2"><link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@docsearch/css@3"><link rel="stylesheet" href="/docs/build/css/styles.css?id=c9d85857d742479204d190fd66fabaf1"><link rel="stylesheet" href="/docs/build/css/mobile.css?id=eb03f5e9c806ca82b2fc8d728401461a" media="screen and (max-width: 979px)"><script src="/docs/build/js/app.js?id=4594e1490acc2ce9d471fb2243cbcfce" defer="defer"></script><link rel="icon" href="/docs/build/favicons/favicon.ico" type="image/x-icon"><link rel="apple-touch-icon-precomposed" sizes="57x57" href="/docs/build/favicons/apple-touch-icon-57x57.png"><link rel="apple-touch-icon-precomposed" sizes="114x114" href="/docs/build/favicons/apple-touch-icon-114x114.png"><link rel="apple-touch-icon-precomposed" sizes="72x72" href="/docs/build/favicons/apple-touch-icon-72x72.png"><link rel="apple-touch-icon-precomposed" sizes="144x144" href="/docs/build/favicons/apple-touch-icon-144x144.png"><link rel="apple-touch-icon-precomposed" sizes="60x60" href="/docs/build/favicons/apple-touch-icon-60x60.png"><link rel="apple-touch-icon-precomposed" sizes="120x120" href="/docs/build/favicons/apple-touch-icon-120x120.png"><link rel="apple-touch-icon-precomposed" sizes="76x76" href="favicons/apple-touch-icon-76x76.png"><link rel="apple-touch-icon-precomposed" sizes="152x152" href="favicons/apple-touch-icon-152x152.png"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-196x196.png" sizes="196x196"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-96x96.png" sizes="96x96"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-32x32.png" sizes="32x32"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-16x16.png" sizes="16x16"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-128.png" sizes="128x128"><meta name="application-name" content="Timber Documentation"><meta name="msapplication-TileColor" content="#FFFFFF"><meta name="msapplication-TileImage" content="/docs/build/favicons/mstile-144x144.png"><meta name="msapplication-square70x70logo" content="/docs/build/favicons/mstile-70x70.png"><meta name="msapplication-square150x150logo" content="/docs/build/favicons/mstile-150x150.png"><meta name="msapplication-wide310x150logo" content="/docs/build/favicons/mstile-310x150.png"><meta name="msapplication-square310x310logo" content="/docs/build/favicons/mstile-310x310.png"><meta name="twitter:card" content="summary_large_image"><meta name="twitter:site" content="@TimberWP"><meta name="twitter:title" content="Timber for WordPress Documentation"><meta name="twitter:description" content="Create WordPress themes with beautiful OOP code and the Twig Template Engine"><meta name="twitter:image" content="https://repository-images.githubusercontent.com/7413451/06c62480-b95c-11ea-8b35-b5dd97d070f1"></head><body><header class="header"><div class="logoContainer"><a href="/docs/"><img src="/docs/build/img/timber-logo.svg" alt="Timber Logo" style="width: 105px; height: 30px; border: 0" role="img"></a></div><div class="search"><div id="docsearch"></div></div><nav class="navTop" id="nav-top"><ul><li><a href="https://upstatement.com/timber/" target="_blank" rel="noreferrer noopener">About Timber</a></li><li><a href="https://twig.symfony.com/doc/" target="_blank" rel="noreferrer noopener">Twig Docs</a></li><li><a href="https://opencollective.com/timber" target="_blank" rel="noreferrer noopener">Sponsor us</a></li><li><a href="https://github.com/timber/timber" target="_blank" rel="noreferrer noopener"><img src="/docs/build/img/github.png" alt="Star on Github" style="width: 29px; height: 29px; border: 0"></a></li></ul></nav><button class="navMobileToggle js-menu-open" type="button" id="nav-mobile-toggle"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 34"><path d="M45.6,19.43H2.4a2.43,2.43,0,0,1,0-4.86H45.6a2.43,2.43,0,0,1,0,4.86Z"/><path d="M45.6,4.86H2.4A2.41,2.41,0,0,1,0,2.43,2.41,2.41,0,0,1,2.4,0H45.6A2.41,2.41,0,0,1,48,2.43,2.41,2.41,0,0,1,45.6,4.86Z"/><path d="M45.6,34H2.4a2.43,2.43,0,0,1,0-4.86H45.6a2.43,2.43,0,0,1,0,4.86Z"/></svg> <span class="sr-only">Menu</span></button></header><div class="wrapper"><aside class="sidebar slideup-menu" id="sidebar" data-turbolinks-keep-scroll-position><button class="navClose js-menu-close" type="button"><div class="navClose-icon" aria-hidden="true"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48"><path d="M3.43,48A3.43,3.43,0,0,1,1,42.15L42.15,1A3.43,3.43,0,1,1,47,5.85L5.85,47A3.4,3.4,0,0,1,3.43,48Z"/><path d="M44.57,48a3.4,3.4,0,0,1-2.42-1L1,5.85A3.43,3.43,0,0,1,5.85,1L47,42.15A3.43,3.43,0,0,1,44.57,48Z"/></svg></div><span class="sr-only">Close Menu</span></button><nav class="navVersions"><ul><li><a href="/docs/v2/" class="is-current">v2.x</a></li><li><a href="/docs/v1/">v1.x</a></li></ul></nav><nav id="nav-main" class="navMain"><ul class="navMain-sections"><li class="navMain-section"><h3 class="navMain-title">Installation</h3><ul class="navMain-items"><li class="navMain-item" data-order="10"><a class="navMain-link" href="/docs/v2/installation/installation/">Installation</a></li><li class="navMain-item" data-order="30"><a class="navMain-link" href="/docs/v2/installation/manage-timber-with-composer/">Managing Timber with Composer</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Getting Started</h3><ul class="navMain-items"><li class="navMain-item" data-order="100"><a class="navMain-link" href="/docs/v2/getting-started/introduction/">Introduction</a></li><li class="navMain-item" data-order="200"><a class="navMain-link" href="/docs/v2/getting-started/template-inheritance-and-includes/">Template inheritance and includes</a></li><li class="navMain-item" data-order="300"><a class="navMain-link" href="/docs/v2/getting-started/a-single-post/">A single post</a></li><li class="navMain-item" data-order="400"><a class="navMain-link" href="/docs/v2/getting-started/a-post-archive/">A post archive</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Guides</h3><ul class="navMain-items"><li class="navMain-item" data-order="50"><a class="navMain-link" href="/docs/v2/guides/context/">Context</a></li><li class="navMain-item" data-order="75"><a class="navMain-link" href="/docs/v2/guides/template-locations/">Template Locations</a></li><li class="navMain-item" data-order="110"><a class="navMain-link" href="/docs/v2/guides/posts/">Posts</a></li><li class="navMain-item" data-order="120"><a class="navMain-link" href="/docs/v2/guides/terms/">Terms</a></li><li class="navMain-item" data-order="130"><a class="navMain-link" href="/docs/v2/guides/users/">Users</a></li><li class="navMain-item" data-order="140"><a class="navMain-link" href="/docs/v2/guides/comments/">Comments</a></li><li class="navMain-item" data-order="150"><a class="navMain-link" href="/docs/v2/guides/menus/">Menus</a></li><li class="navMain-item" data-order="160"><a class="navMain-link" href="/docs/v2/guides/widgets/">Widgets</a></li><li class="navMain-item" data-order="170"><a class="navMain-link" href="/docs/v2/guides/shortcodes/">Shortcodes</a></li><li class="navMain-item" data-order="200"><a class="navMain-link" href="/docs/v2/guides/twig/">Twig</a></li><li class="navMain-item" data-order="220"><a class="navMain-link" href="/docs/v2/guides/twig-filters/">Twig filters</a></li><li class="navMain-item" data-order="300"><a class="navMain-link" href="/docs/v2/guides/cookbook-text/">Text Cookbook</a></li><li class="navMain-item" data-order="400"><a class="navMain-link" href="/docs/v2/guides/escaping/">Escaping</a></li><li class="navMain-item" data-order="500"><a class="navMain-link" href="/docs/v2/guides/custom-page-templates/">Custom Page Templates</a></li><li class="navMain-item" data-order="600"><a class="navMain-link" href="/docs/v2/guides/custom-fields/">Custom Fields</a></li><li class="navMain-item" data-order="800"><a class="navMain-link" href="/docs/v2/guides/functions/">Functions</a></li><li class="navMain-item" data-order="1000"><a class="navMain-link" href="/docs/v2/guides/cookbook-images/">Image Cookbook</a></li><li class="navMain-item" data-order="1100"><a class="navMain-link" href="/docs/v2/guides/pagination/">Pagination</a></li><li class="navMain-item" data-order="1200"><a class="navMain-link" href="/docs/v2/guides/sidebars/">Sidebars</a></li><li class="navMain-item" data-order="1300"><a class="navMain-link" href="/docs/v2/guides/performance/">Performance/Caching</a></li><li class="navMain-item" data-order="1350"><a class="navMain-link" href="/docs/v2/guides/date-time/">Date/Time in Timber</a></li><li class="navMain-item" data-order="1400"><a class="navMain-link" href="/docs/v2/guides/internationalization/">Internationalization</a></li><li class="navMain-item" data-order="1500"><a class="navMain-link" href="/docs/v2/guides/cheatsheet/">Cheatsheet</a></li><li class="navMain-item" data-order="1550"><a class="navMain-link" href="/docs/v2/guides/gutenberg/">Block Editor (Gutenberg)</a></li><li class="navMain-item" data-order="1600"><a class="navMain-link" href="/docs/v2/guides/extending-timber/">Extending Timber</a></li><li class="navMain-item" data-order="1650"><a class="navMain-link" href="/docs/v2/guides/extending-twig/">Extending Twig</a></li><li class="navMain-item" data-order="1660"><a class="navMain-link" href="/docs/v2/guides/class-maps/">Class Maps</a></li><li class="navMain-item" data-order="1670"><a class="navMain-link" href="/docs/v2/guides/wp-cli/">WP-CLI</a></li><li class="navMain-item" data-order="1700"><a class="navMain-link" href="/docs/v2/guides/hosts-servers/">Hosts &amp; Servers</a></li><li class="navMain-item" data-order="1800"><a class="navMain-link" href="/docs/v2/guides/debugging/">Debugging</a></li><li class="navMain-item" data-order="1900"><a class="navMain-link" href="/docs/v2/guides/testing/">Automated Testing</a></li><li class="navMain-item" data-order="2000"><a class="navMain-link" href="/docs/v2/guides/routing/">Routing</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/guides/custom-integrations/">Custom Integrations</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/guides/woocommerce/">WooCommerce</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Reference</h3><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-archives/">Archives</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-attachment/">Attachment</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-cache-cleaner/">Cleaner</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-comment/">Comment</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-datetimehelper/">DateTimeHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-externalimage/">ExternalImage</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-helper/">Helper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-image/">Image</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-imagedimensions/">ImageDimensions</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-imagehelper/">ImageHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-menu/">Menu</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-menuitem/">MenuItem</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-pagesmenu/">PagesMenu</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-pagination/">Pagination</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-pathhelper/">PathHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-post/">Post</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-postarrayobject/">PostArrayObject</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-postexcerpt/">PostExcerpt</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-postquery/">PostQuery</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-site/">Site</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-term/">Term</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-texthelper/">TextHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-theme/">Theme</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-timber/">Timber</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-urlhelper/">URLHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-user/">User</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title navMain-sectionTitle">Hooks</h3><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/hooks/actions/" aria-current>Action Hooks</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/hooks/filters/">Filter Hooks</a></li></ul></li><li class="navMain-section"><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/integrations/advanced-custom-fields/">Advanced Custom Fields</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Upgrade Guides</h3><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/upgrade-guides/1.0/">Upgrade to 1.0</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/upgrade-guides/2.0/">Upgrade to 2.0</a></li></ul></li><li class="navMain-section"><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/contributing/">Contributing to Timber</a></li></ul></li></ul></nav></aside><div class="main-container"><div class="version-note"><p>You are reading the documentation for <strong>Timber v2.x</strong>. Switch to the documentation for Timber <a href="/docs/v1/">v1.x</a>.</p></div><main><article><h1>Action Hooks</h1><aside><h2 class="heading-small">On this page</h2><nav class="toc"><ol><li><a href="#timber_{dollarobject_type}_get_meta_pre">timber_{$object_type}_get_meta_pre</a></li><li><a href="#timber/loader/render_file">timber/loader/render_file</a></li><li><a href="#timber_loader_render_file">timber_loader_render_file</a></li><li><a href="#timber/calling_php_file">timber/calling_php_file</a></li><li><a href="#timber/compile/done">timber/compile/done</a></li><li><a href="#timber_compile_done">timber_compile_done</a></li></ol></nav></aside><div class="content"><h2 id="timber_{dollarobject_type}_get_meta_pre" tabindex="-1">timber_{$object_type}_get_meta_pre <a class="directLink" href="#timber_{dollarobject_type}_get_meta_pre">#</a></h2><p>Filters post meta data before it is fetched from the database.</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/{object_type}/pre_meta</code></p><h2 id="timber/loader/render_file" tabindex="-1">timber/loader/render_file <a class="directLink" href="#timber/loader/render_file">#</a></h2><p>Fires after …</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$result</td><td><code>string</code></td><td></td></tr></tbody></table><h2 id="timber_loader_render_file" tabindex="-1">timber_loader_render_file <a class="directLink" href="#timber_loader_render_file">#</a></h2><p>Fires after …</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/loader/render_file</code></p><p>This action is used by the Timber Debug Bar extension.</p><h2 id="timber/calling_php_file" tabindex="-1">timber/calling_php_file <a class="directLink" href="#timber/calling_php_file">#</a></h2><p>Fires after the calling PHP file was determined in Timber’s compile function.</p><p>This action is used by the Timber Debug Bar extension.</p><p><strong>since</strong> 1.1.2</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$caller_file</td><td><code>string</code> or <code>null</code></td><td>The calling script file.</td></tr></tbody></table><h2 id="timber/compile/done" tabindex="-1">timber/compile/done <a class="directLink" href="#timber/compile/done">#</a></h2><p>Fires after a Twig template was compiled and before the compiled data is returned.</p><p>This action can be helpful if you need to debug Twig template compilation.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$output</td><td><code>string</code></td><td>The compiled output.</td></tr><tr><td>$file</td><td><code>string</code></td><td>The name of the Twig template that was compiled.</td></tr><tr><td>$data</td><td><code>array</code></td><td>The data that was used to compile the Twig template.</td></tr><tr><td>$expires</td><td><code>bool</code> or <code>int</code> or <code>array</code></td><td>The expiration time of the cache in seconds, or false to disable cache.</td></tr><tr><td>$cache_mode</td><td><code>string</code></td><td>Any of the cache mode constants defined in Timber\Loader.</td></tr></tbody></table><h2 id="timber_compile_done" tabindex="-1">timber_compile_done <a class="directLink" href="#timber_compile_done">#</a></h2><p>Fires after a Twig template was compiled and before the compiled data is returned.</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/compile/done</code></p></div></article></main></div></div><script src="https://cdn.jsdelivr.net/npm/@docsearch/js@3"></script><script>docsearch({
     appId: '7REN4GR6X4',
     apiKey: '9acbf22ef9a9b117a0f9ba50bd2f4280',
     /**
diff --git a/docs/v2/hooks/filters/index.html b/docs/v2/hooks/filters/index.html
index fa87f311..cc8d9580 100644
--- a/docs/v2/hooks/filters/index.html
+++ b/docs/v2/hooks/filters/index.html
@@ -2,7 +2,132 @@
 	  function gtag(){dataLayer.push(arguments);}
 	  gtag('js', new Date());
 
-	  gtag('config', 'UA-126807198-1');</script><title>Filter Hooks – Timber v2 – Timber Documentation</title><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta http-equiv="x-ua-compatible" content="ie=edge"><meta name="docsearch:version" content="v2"><link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@docsearch/css@3"><link rel="stylesheet" href="/docs/build/css/styles.css?id=c9d85857d742479204d190fd66fabaf1"><link rel="stylesheet" href="/docs/build/css/mobile.css?id=eb03f5e9c806ca82b2fc8d728401461a" media="screen and (max-width: 979px)"><script src="/docs/build/js/app.js?id=4594e1490acc2ce9d471fb2243cbcfce" defer="defer"></script><link rel="icon" href="/docs/build/favicons/favicon.ico" type="image/x-icon"><link rel="apple-touch-icon-precomposed" sizes="57x57" href="/docs/build/favicons/apple-touch-icon-57x57.png"><link rel="apple-touch-icon-precomposed" sizes="114x114" href="/docs/build/favicons/apple-touch-icon-114x114.png"><link rel="apple-touch-icon-precomposed" sizes="72x72" href="/docs/build/favicons/apple-touch-icon-72x72.png"><link rel="apple-touch-icon-precomposed" sizes="144x144" href="/docs/build/favicons/apple-touch-icon-144x144.png"><link rel="apple-touch-icon-precomposed" sizes="60x60" href="/docs/build/favicons/apple-touch-icon-60x60.png"><link rel="apple-touch-icon-precomposed" sizes="120x120" href="/docs/build/favicons/apple-touch-icon-120x120.png"><link rel="apple-touch-icon-precomposed" sizes="76x76" href="favicons/apple-touch-icon-76x76.png"><link rel="apple-touch-icon-precomposed" sizes="152x152" href="favicons/apple-touch-icon-152x152.png"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-196x196.png" sizes="196x196"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-96x96.png" sizes="96x96"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-32x32.png" sizes="32x32"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-16x16.png" sizes="16x16"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-128.png" sizes="128x128"><meta name="application-name" content="Timber Documentation"><meta name="msapplication-TileColor" content="#FFFFFF"><meta name="msapplication-TileImage" content="/docs/build/favicons/mstile-144x144.png"><meta name="msapplication-square70x70logo" content="/docs/build/favicons/mstile-70x70.png"><meta name="msapplication-square150x150logo" content="/docs/build/favicons/mstile-150x150.png"><meta name="msapplication-wide310x150logo" content="/docs/build/favicons/mstile-310x150.png"><meta name="msapplication-square310x310logo" content="/docs/build/favicons/mstile-310x310.png"><meta name="twitter:card" content="summary_large_image"><meta name="twitter:site" content="@TimberWP"><meta name="twitter:title" content="Timber for WordPress Documentation"><meta name="twitter:description" content="Create WordPress themes with beautiful OOP code and the Twig Template Engine"><meta name="twitter:image" content="https://repository-images.githubusercontent.com/7413451/06c62480-b95c-11ea-8b35-b5dd97d070f1"></head><body><header class="header"><div class="logoContainer"><a href="/docs/"><img src="/docs/build/img/timber-logo.svg" alt="Timber Logo" style="width: 105px; height: 30px; border: 0" role="img"></a></div><div class="search"><div id="docsearch"></div></div><nav class="navTop" id="nav-top"><ul><li><a href="https://upstatement.com/timber/" target="_blank" rel="noreferrer noopener">About Timber</a></li><li><a href="https://twig.symfony.com/doc/" target="_blank" rel="noreferrer noopener">Twig Docs</a></li><li><a href="https://opencollective.com/timber" target="_blank" rel="noreferrer noopener">Sponsor us</a></li><li><a href="https://github.com/timber/timber" target="_blank" rel="noreferrer noopener"><img src="/docs/build/img/github.png" alt="Star on Github" style="width: 29px; height: 29px; border: 0"></a></li></ul></nav><button class="navMobileToggle js-menu-open" type="button" id="nav-mobile-toggle"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 34"><path d="M45.6,19.43H2.4a2.43,2.43,0,0,1,0-4.86H45.6a2.43,2.43,0,0,1,0,4.86Z"/><path d="M45.6,4.86H2.4A2.41,2.41,0,0,1,0,2.43,2.41,2.41,0,0,1,2.4,0H45.6A2.41,2.41,0,0,1,48,2.43,2.41,2.41,0,0,1,45.6,4.86Z"/><path d="M45.6,34H2.4a2.43,2.43,0,0,1,0-4.86H45.6a2.43,2.43,0,0,1,0,4.86Z"/></svg> <span class="sr-only">Menu</span></button></header><div class="wrapper"><aside class="sidebar slideup-menu" id="sidebar" data-turbolinks-keep-scroll-position><button class="navClose js-menu-close" type="button"><div class="navClose-icon" aria-hidden="true"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48"><path d="M3.43,48A3.43,3.43,0,0,1,1,42.15L42.15,1A3.43,3.43,0,1,1,47,5.85L5.85,47A3.4,3.4,0,0,1,3.43,48Z"/><path d="M44.57,48a3.4,3.4,0,0,1-2.42-1L1,5.85A3.43,3.43,0,0,1,5.85,1L47,42.15A3.43,3.43,0,0,1,44.57,48Z"/></svg></div><span class="sr-only">Close Menu</span></button><nav class="navVersions"><ul><li><a href="/docs/v2/" class="is-current">v2.x</a></li><li><a href="/docs/v1/">v1.x</a></li></ul></nav><nav id="nav-main" class="navMain"><ul class="navMain-sections"><li class="navMain-section"><h3 class="navMain-title">Installation</h3><ul class="navMain-items"><li class="navMain-item" data-order="10"><a class="navMain-link" href="/docs/v2/installation/installation/">Installation</a></li><li class="navMain-item" data-order="30"><a class="navMain-link" href="/docs/v2/installation/manage-timber-with-composer/">Managing Timber with Composer</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Getting Started</h3><ul class="navMain-items"><li class="navMain-item" data-order="100"><a class="navMain-link" href="/docs/v2/getting-started/introduction/">Introduction</a></li><li class="navMain-item" data-order="200"><a class="navMain-link" href="/docs/v2/getting-started/template-inheritance-and-includes/">Template inheritance and includes</a></li><li class="navMain-item" data-order="300"><a class="navMain-link" href="/docs/v2/getting-started/a-single-post/">A single post</a></li><li class="navMain-item" data-order="400"><a class="navMain-link" href="/docs/v2/getting-started/a-post-archive/">A post archive</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Guides</h3><ul class="navMain-items"><li class="navMain-item" data-order="50"><a class="navMain-link" href="/docs/v2/guides/context/">Context</a></li><li class="navMain-item" data-order="75"><a class="navMain-link" href="/docs/v2/guides/template-locations/">Template Locations</a></li><li class="navMain-item" data-order="110"><a class="navMain-link" href="/docs/v2/guides/posts/">Posts</a></li><li class="navMain-item" data-order="120"><a class="navMain-link" href="/docs/v2/guides/terms/">Terms</a></li><li class="navMain-item" data-order="130"><a class="navMain-link" href="/docs/v2/guides/users/">Users</a></li><li class="navMain-item" data-order="140"><a class="navMain-link" href="/docs/v2/guides/comments/">Comments</a></li><li class="navMain-item" data-order="150"><a class="navMain-link" href="/docs/v2/guides/menus/">Menus</a></li><li class="navMain-item" data-order="160"><a class="navMain-link" href="/docs/v2/guides/widgets/">Widgets</a></li><li class="navMain-item" data-order="170"><a class="navMain-link" href="/docs/v2/guides/shortcodes/">Shortcodes</a></li><li class="navMain-item" data-order="200"><a class="navMain-link" href="/docs/v2/guides/twig/">Twig</a></li><li class="navMain-item" data-order="220"><a class="navMain-link" href="/docs/v2/guides/twig-filters/">Twig filters</a></li><li class="navMain-item" data-order="300"><a class="navMain-link" href="/docs/v2/guides/cookbook-text/">Text Cookbook</a></li><li class="navMain-item" data-order="400"><a class="navMain-link" href="/docs/v2/guides/escaping/">Escaping</a></li><li class="navMain-item" data-order="500"><a class="navMain-link" href="/docs/v2/guides/custom-page-templates/">Custom Page Templates</a></li><li class="navMain-item" data-order="600"><a class="navMain-link" href="/docs/v2/guides/custom-fields/">Custom Fields</a></li><li class="navMain-item" data-order="800"><a class="navMain-link" href="/docs/v2/guides/functions/">Functions</a></li><li class="navMain-item" data-order="1000"><a class="navMain-link" href="/docs/v2/guides/cookbook-images/">Image Cookbook</a></li><li class="navMain-item" data-order="1100"><a class="navMain-link" href="/docs/v2/guides/pagination/">Pagination</a></li><li class="navMain-item" data-order="1200"><a class="navMain-link" href="/docs/v2/guides/sidebars/">Sidebars</a></li><li class="navMain-item" data-order="1300"><a class="navMain-link" href="/docs/v2/guides/performance/">Performance/Caching</a></li><li class="navMain-item" data-order="1350"><a class="navMain-link" href="/docs/v2/guides/date-time/">Date/Time in Timber</a></li><li class="navMain-item" data-order="1400"><a class="navMain-link" href="/docs/v2/guides/internationalization/">Internationalization</a></li><li class="navMain-item" data-order="1500"><a class="navMain-link" href="/docs/v2/guides/cheatsheet/">Cheatsheet</a></li><li class="navMain-item" data-order="1550"><a class="navMain-link" href="/docs/v2/guides/gutenberg/">Block Editor (Gutenberg)</a></li><li class="navMain-item" data-order="1600"><a class="navMain-link" href="/docs/v2/guides/extending-timber/">Extending Timber</a></li><li class="navMain-item" data-order="1650"><a class="navMain-link" href="/docs/v2/guides/extending-twig/">Extending Twig</a></li><li class="navMain-item" data-order="1660"><a class="navMain-link" href="/docs/v2/guides/class-maps/">Class Maps</a></li><li class="navMain-item" data-order="1670"><a class="navMain-link" href="/docs/v2/guides/wp-cli/">WP-CLI</a></li><li class="navMain-item" data-order="1700"><a class="navMain-link" href="/docs/v2/guides/hosts-servers/">Hosts &amp; Servers</a></li><li class="navMain-item" data-order="1800"><a class="navMain-link" href="/docs/v2/guides/debugging/">Debugging</a></li><li class="navMain-item" data-order="1900"><a class="navMain-link" href="/docs/v2/guides/testing/">Automated Testing</a></li><li class="navMain-item" data-order="2000"><a class="navMain-link" href="/docs/v2/guides/routing/">Routing</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/guides/custom-integrations/">Custom Integrations</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/guides/woocommerce/">WooCommerce</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Reference</h3><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-archives/">Archives</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-attachment/">Attachment</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-cache-cleaner/">Cleaner</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-comment/">Comment</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-datetimehelper/">DateTimeHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-externalimage/">ExternalImage</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-helper/">Helper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-image/">Image</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-imagedimensions/">ImageDimensions</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-imagehelper/">ImageHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-menu/">Menu</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-menuitem/">MenuItem</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-pagesmenu/">PagesMenu</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-pagination/">Pagination</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-pathhelper/">PathHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-post/">Post</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-postarrayobject/">PostArrayObject</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-postexcerpt/">PostExcerpt</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-postquery/">PostQuery</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-site/">Site</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-term/">Term</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-texthelper/">TextHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-theme/">Theme</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-timber/">Timber</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-urlhelper/">URLHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-user/">User</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title navMain-sectionTitle">Hooks</h3><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/hooks/actions/">Action Hooks</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/hooks/filters/" aria-current>Filter Hooks</a></li></ul></li><li class="navMain-section"><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/integrations/advanced-custom-fields/">Advanced Custom Fields</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Upgrade Guides</h3><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/upgrade-guides/1.0/">Upgrade to 1.0</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/upgrade-guides/2.0/">Upgrade to 2.0</a></li></ul></li><li class="navMain-section"><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/contributing/">Contributing to Timber</a></li></ul></li></ul></nav></aside><div class="main-container"><div class="version-note"><p>You are reading the documentation for <strong>Timber v2.x</strong>. Switch to the documentation for Timber <a href="/docs/v1/">v1.x</a>.</p></div><main><article><h1>Filter Hooks</h1><div class="content"></div></article></main></div></div><script src="https://cdn.jsdelivr.net/npm/@docsearch/js@3"></script><script>docsearch({
+	  gtag('config', 'UA-126807198-1');</script><title>Filter Hooks – Timber v2 – Timber Documentation</title><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta http-equiv="x-ua-compatible" content="ie=edge"><meta name="docsearch:version" content="v2"><link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@docsearch/css@3"><link rel="stylesheet" href="/docs/build/css/styles.css?id=c9d85857d742479204d190fd66fabaf1"><link rel="stylesheet" href="/docs/build/css/mobile.css?id=eb03f5e9c806ca82b2fc8d728401461a" media="screen and (max-width: 979px)"><script src="/docs/build/js/app.js?id=4594e1490acc2ce9d471fb2243cbcfce" defer="defer"></script><link rel="icon" href="/docs/build/favicons/favicon.ico" type="image/x-icon"><link rel="apple-touch-icon-precomposed" sizes="57x57" href="/docs/build/favicons/apple-touch-icon-57x57.png"><link rel="apple-touch-icon-precomposed" sizes="114x114" href="/docs/build/favicons/apple-touch-icon-114x114.png"><link rel="apple-touch-icon-precomposed" sizes="72x72" href="/docs/build/favicons/apple-touch-icon-72x72.png"><link rel="apple-touch-icon-precomposed" sizes="144x144" href="/docs/build/favicons/apple-touch-icon-144x144.png"><link rel="apple-touch-icon-precomposed" sizes="60x60" href="/docs/build/favicons/apple-touch-icon-60x60.png"><link rel="apple-touch-icon-precomposed" sizes="120x120" href="/docs/build/favicons/apple-touch-icon-120x120.png"><link rel="apple-touch-icon-precomposed" sizes="76x76" href="favicons/apple-touch-icon-76x76.png"><link rel="apple-touch-icon-precomposed" sizes="152x152" href="favicons/apple-touch-icon-152x152.png"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-196x196.png" sizes="196x196"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-96x96.png" sizes="96x96"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-32x32.png" sizes="32x32"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-16x16.png" sizes="16x16"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-128.png" sizes="128x128"><meta name="application-name" content="Timber Documentation"><meta name="msapplication-TileColor" content="#FFFFFF"><meta name="msapplication-TileImage" content="/docs/build/favicons/mstile-144x144.png"><meta name="msapplication-square70x70logo" content="/docs/build/favicons/mstile-70x70.png"><meta name="msapplication-square150x150logo" content="/docs/build/favicons/mstile-150x150.png"><meta name="msapplication-wide310x150logo" content="/docs/build/favicons/mstile-310x150.png"><meta name="msapplication-square310x310logo" content="/docs/build/favicons/mstile-310x310.png"><meta name="twitter:card" content="summary_large_image"><meta name="twitter:site" content="@TimberWP"><meta name="twitter:title" content="Timber for WordPress Documentation"><meta name="twitter:description" content="Create WordPress themes with beautiful OOP code and the Twig Template Engine"><meta name="twitter:image" content="https://repository-images.githubusercontent.com/7413451/06c62480-b95c-11ea-8b35-b5dd97d070f1"></head><body><header class="header"><div class="logoContainer"><a href="/docs/"><img src="/docs/build/img/timber-logo.svg" alt="Timber Logo" style="width: 105px; height: 30px; border: 0" role="img"></a></div><div class="search"><div id="docsearch"></div></div><nav class="navTop" id="nav-top"><ul><li><a href="https://upstatement.com/timber/" target="_blank" rel="noreferrer noopener">About Timber</a></li><li><a href="https://twig.symfony.com/doc/" target="_blank" rel="noreferrer noopener">Twig Docs</a></li><li><a href="https://opencollective.com/timber" target="_blank" rel="noreferrer noopener">Sponsor us</a></li><li><a href="https://github.com/timber/timber" target="_blank" rel="noreferrer noopener"><img src="/docs/build/img/github.png" alt="Star on Github" style="width: 29px; height: 29px; border: 0"></a></li></ul></nav><button class="navMobileToggle js-menu-open" type="button" id="nav-mobile-toggle"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 34"><path d="M45.6,19.43H2.4a2.43,2.43,0,0,1,0-4.86H45.6a2.43,2.43,0,0,1,0,4.86Z"/><path d="M45.6,4.86H2.4A2.41,2.41,0,0,1,0,2.43,2.41,2.41,0,0,1,2.4,0H45.6A2.41,2.41,0,0,1,48,2.43,2.41,2.41,0,0,1,45.6,4.86Z"/><path d="M45.6,34H2.4a2.43,2.43,0,0,1,0-4.86H45.6a2.43,2.43,0,0,1,0,4.86Z"/></svg> <span class="sr-only">Menu</span></button></header><div class="wrapper"><aside class="sidebar slideup-menu" id="sidebar" data-turbolinks-keep-scroll-position><button class="navClose js-menu-close" type="button"><div class="navClose-icon" aria-hidden="true"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48"><path d="M3.43,48A3.43,3.43,0,0,1,1,42.15L42.15,1A3.43,3.43,0,1,1,47,5.85L5.85,47A3.4,3.4,0,0,1,3.43,48Z"/><path d="M44.57,48a3.4,3.4,0,0,1-2.42-1L1,5.85A3.43,3.43,0,0,1,5.85,1L47,42.15A3.43,3.43,0,0,1,44.57,48Z"/></svg></div><span class="sr-only">Close Menu</span></button><nav class="navVersions"><ul><li><a href="/docs/v2/" class="is-current">v2.x</a></li><li><a href="/docs/v1/">v1.x</a></li></ul></nav><nav id="nav-main" class="navMain"><ul class="navMain-sections"><li class="navMain-section"><h3 class="navMain-title">Installation</h3><ul class="navMain-items"><li class="navMain-item" data-order="10"><a class="navMain-link" href="/docs/v2/installation/installation/">Installation</a></li><li class="navMain-item" data-order="30"><a class="navMain-link" href="/docs/v2/installation/manage-timber-with-composer/">Managing Timber with Composer</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Getting Started</h3><ul class="navMain-items"><li class="navMain-item" data-order="100"><a class="navMain-link" href="/docs/v2/getting-started/introduction/">Introduction</a></li><li class="navMain-item" data-order="200"><a class="navMain-link" href="/docs/v2/getting-started/template-inheritance-and-includes/">Template inheritance and includes</a></li><li class="navMain-item" data-order="300"><a class="navMain-link" href="/docs/v2/getting-started/a-single-post/">A single post</a></li><li class="navMain-item" data-order="400"><a class="navMain-link" href="/docs/v2/getting-started/a-post-archive/">A post archive</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Guides</h3><ul class="navMain-items"><li class="navMain-item" data-order="50"><a class="navMain-link" href="/docs/v2/guides/context/">Context</a></li><li class="navMain-item" data-order="75"><a class="navMain-link" href="/docs/v2/guides/template-locations/">Template Locations</a></li><li class="navMain-item" data-order="110"><a class="navMain-link" href="/docs/v2/guides/posts/">Posts</a></li><li class="navMain-item" data-order="120"><a class="navMain-link" href="/docs/v2/guides/terms/">Terms</a></li><li class="navMain-item" data-order="130"><a class="navMain-link" href="/docs/v2/guides/users/">Users</a></li><li class="navMain-item" data-order="140"><a class="navMain-link" href="/docs/v2/guides/comments/">Comments</a></li><li class="navMain-item" data-order="150"><a class="navMain-link" href="/docs/v2/guides/menus/">Menus</a></li><li class="navMain-item" data-order="160"><a class="navMain-link" href="/docs/v2/guides/widgets/">Widgets</a></li><li class="navMain-item" data-order="170"><a class="navMain-link" href="/docs/v2/guides/shortcodes/">Shortcodes</a></li><li class="navMain-item" data-order="200"><a class="navMain-link" href="/docs/v2/guides/twig/">Twig</a></li><li class="navMain-item" data-order="220"><a class="navMain-link" href="/docs/v2/guides/twig-filters/">Twig filters</a></li><li class="navMain-item" data-order="300"><a class="navMain-link" href="/docs/v2/guides/cookbook-text/">Text Cookbook</a></li><li class="navMain-item" data-order="400"><a class="navMain-link" href="/docs/v2/guides/escaping/">Escaping</a></li><li class="navMain-item" data-order="500"><a class="navMain-link" href="/docs/v2/guides/custom-page-templates/">Custom Page Templates</a></li><li class="navMain-item" data-order="600"><a class="navMain-link" href="/docs/v2/guides/custom-fields/">Custom Fields</a></li><li class="navMain-item" data-order="800"><a class="navMain-link" href="/docs/v2/guides/functions/">Functions</a></li><li class="navMain-item" data-order="1000"><a class="navMain-link" href="/docs/v2/guides/cookbook-images/">Image Cookbook</a></li><li class="navMain-item" data-order="1100"><a class="navMain-link" href="/docs/v2/guides/pagination/">Pagination</a></li><li class="navMain-item" data-order="1200"><a class="navMain-link" href="/docs/v2/guides/sidebars/">Sidebars</a></li><li class="navMain-item" data-order="1300"><a class="navMain-link" href="/docs/v2/guides/performance/">Performance/Caching</a></li><li class="navMain-item" data-order="1350"><a class="navMain-link" href="/docs/v2/guides/date-time/">Date/Time in Timber</a></li><li class="navMain-item" data-order="1400"><a class="navMain-link" href="/docs/v2/guides/internationalization/">Internationalization</a></li><li class="navMain-item" data-order="1500"><a class="navMain-link" href="/docs/v2/guides/cheatsheet/">Cheatsheet</a></li><li class="navMain-item" data-order="1550"><a class="navMain-link" href="/docs/v2/guides/gutenberg/">Block Editor (Gutenberg)</a></li><li class="navMain-item" data-order="1600"><a class="navMain-link" href="/docs/v2/guides/extending-timber/">Extending Timber</a></li><li class="navMain-item" data-order="1650"><a class="navMain-link" href="/docs/v2/guides/extending-twig/">Extending Twig</a></li><li class="navMain-item" data-order="1660"><a class="navMain-link" href="/docs/v2/guides/class-maps/">Class Maps</a></li><li class="navMain-item" data-order="1670"><a class="navMain-link" href="/docs/v2/guides/wp-cli/">WP-CLI</a></li><li class="navMain-item" data-order="1700"><a class="navMain-link" href="/docs/v2/guides/hosts-servers/">Hosts &amp; Servers</a></li><li class="navMain-item" data-order="1800"><a class="navMain-link" href="/docs/v2/guides/debugging/">Debugging</a></li><li class="navMain-item" data-order="1900"><a class="navMain-link" href="/docs/v2/guides/testing/">Automated Testing</a></li><li class="navMain-item" data-order="2000"><a class="navMain-link" href="/docs/v2/guides/routing/">Routing</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/guides/custom-integrations/">Custom Integrations</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/guides/woocommerce/">WooCommerce</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Reference</h3><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-archives/">Archives</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-attachment/">Attachment</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-cache-cleaner/">Cleaner</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-comment/">Comment</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-datetimehelper/">DateTimeHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-externalimage/">ExternalImage</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-helper/">Helper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-image/">Image</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-imagedimensions/">ImageDimensions</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-imagehelper/">ImageHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-menu/">Menu</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-menuitem/">MenuItem</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-pagesmenu/">PagesMenu</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-pagination/">Pagination</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-pathhelper/">PathHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-post/">Post</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-postarrayobject/">PostArrayObject</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-postexcerpt/">PostExcerpt</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-postquery/">PostQuery</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-site/">Site</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-term/">Term</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-texthelper/">TextHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-theme/">Theme</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-timber/">Timber</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-urlhelper/">URLHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-user/">User</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title navMain-sectionTitle">Hooks</h3><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/hooks/actions/">Action Hooks</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/hooks/filters/" aria-current>Filter Hooks</a></li></ul></li><li class="navMain-section"><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/integrations/advanced-custom-fields/">Advanced Custom Fields</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Upgrade Guides</h3><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/upgrade-guides/1.0/">Upgrade to 1.0</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/upgrade-guides/2.0/">Upgrade to 2.0</a></li></ul></li><li class="navMain-section"><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/contributing/">Contributing to Timber</a></li></ul></li></ul></nav></aside><div class="main-container"><div class="version-note"><p>You are reading the documentation for <strong>Timber v2.x</strong>. Switch to the documentation for Timber <a href="/docs/v1/">v1.x</a>.</p></div><main><article><h1>Filter Hooks</h1><aside><h2 class="heading-small">On this page</h2><nav class="toc"><ol><li><a href="#timber/meta/transform_value">timber/meta/transform_value</a></li><li><a href="#timber/{dollarobject_type}/pre_meta">timber/{$object_type}/pre_meta</a></li><li><a href="#timber_{dollarobject_type}_get_meta_field_pre">timber_{$object_type}_get_meta_field_pre</a></li><li><a href="#timber/{dollarobject_type}/meta">timber/{$object_type}/meta</a></li><li><a href="#timber/term/meta/field">timber/term/meta/field</a></li><li><a href="#timber_{dollarobject_type}_get_meta_field">timber_{$object_type}_get_meta_field</a></li><li><a href="#timber_{dollarobject_type}_get_meta">timber_{$object_type}_get_meta</a></li><li><a href="#timber/comment/classmap">timber/comment/classmap</a></li><li><a href="#timber/comment/class">timber/comment/class</a></li><li><a href="#timber/menu/classmap">timber/menu/classmap</a></li><li><a href="#timber/menu/class">timber/menu/class</a></li><li><a href="#timber/menuitem/classmap">timber/menuitem/classmap</a></li><li><a href="#timber/menuitem/class">timber/menuitem/class</a></li><li><a href="#timber/pages_menu/class">timber/pages_menu/class</a></li><li><a href="#timber/post/classmap">timber/post/classmap</a></li><li><a href="#timber/post/class">timber/post/class</a></li><li><a href="#timber/post/image_extensions">timber/post/image_extensions</a></li><li><a href="#timber/term/classmap">timber/term/classmap</a></li><li><a href="#timber/term/class">timber/term/class</a></li><li><a href="#timber/user/class">timber/user/class</a></li><li><a href="#timber/transient/slug">timber/transient/slug</a></li><li><a href="#timber/transient/force_transients">timber/transient/force_transients</a></li><li><a href="#timber_force_transients">timber_force_transients</a></li><li><a href="#timber/transient/force_transient_{dollarslug}">timber/transient/force_transient_{$slug}</a></li><li><a href="#timber_force_transient_{dollarslug}">timber_force_transient_{$slug}</a></li><li><a href="#timber/helper/wp_title_separator">timber/helper/wp_title_separator</a></li><li><a href="#timber_wp_title_seperator">timber_wp_title_seperator</a></li><li><a href="#timber/image/src">timber/image/src</a></li><li><a href="#timber_image_src">timber_image_src</a></li><li><a href="#timber/sideload_image/basename">timber/sideload_image/basename</a></li><li><a href="#timber/sideload_image/subdir">timber/sideload_image/subdir</a></li><li><a href="#timber/image_helper/pre_analyze_url">timber/image_helper/pre_analyze_url</a></li><li><a href="#timber/image_helper/analyze_url">timber/image_helper/analyze_url</a></li><li><a href="#timber/image_helper/pre_theme_url_to_dir">timber/image_helper/pre_theme_url_to_dir</a></li><li><a href="#timber/image_helper/theme_url_to_dir">timber/image_helper/theme_url_to_dir</a></li><li><a href="#timber/image/new_url">timber/image/new_url</a></li><li><a href="#timber/image/new_path">timber/image/new_path</a></li><li><a href="#timber/cache/mode">timber/cache/mode</a></li><li><a href="#timber_cache_mode">timber_cache_mode</a></li><li><a href="#timber/loader/render_data">timber/loader/render_data</a></li><li><a href="#timber_loader_render_data">timber_loader_render_data</a></li><li><a href="#timber/output/pre-cache">timber/output/pre-cache</a></li><li><a href="#timber/output">timber/output</a></li><li><a href="#timber_output">timber_output</a></li><li><a href="#timber/loader/paths">timber/loader/paths</a></li><li><a href="#timber/loader/loader">timber/loader/loader</a></li><li><a href="#timber/twig/environment/options">timber/twig/environment/options</a></li><li><a href="#timber/cache/location">timber/cache/location</a></li><li><a href="#timber/cache/enable_extension">timber/cache/enable_extension</a></li><li><a href="#timber/loader/twig">timber/loader/twig</a></li><li><a href="#timber/twig">timber/twig</a></li><li><a href="#timber/cache/extension/lifetime">timber/cache/extension/lifetime</a></li><li><a href="#timber/cache/transient_key">timber/cache/transient_key</a></li><li><a href="#timber/cache/transient_key-1">timber/cache/transient_key</a></li><li><a href="#timber/locations">timber/locations</a></li><li><a href="#timber_locations">timber_locations</a></li><li><a href="#timber/menu/item_objects">timber/menu/item_objects</a></li><li><a href="#timber/post/import_data">timber/post/import_data</a></li><li><a href="#timber/post/meta_object_field">timber/post/meta_object_field</a></li><li><a href="#timber/post/authors">timber/post/authors</a></li><li><a href="#timber/post/children_args">timber/post/children_args</a></li><li><a href="#timber/post/content/show_password_form_for_protected">timber/post/content/show_password_form_for_protected</a></li><li><a href="#timber/post/content/password_form">timber/post/content/password_form</a></li><li><a href="#timber/post/content/remove_blocks">timber/post/content/remove_blocks</a></li><li><a href="#timber/post/excerpt/defaults">timber/post/excerpt/defaults</a></li><li><a href="#timber/post/excerpt/read_more_class">timber/post/excerpt/read_more_class</a></li><li><a href="#timber/post/preview/read_more_class">timber/post/preview/read_more_class</a></li><li><a href="#timber/post/excerpt/read_more_link">timber/post/excerpt/read_more_link</a></li><li><a href="#timber/post/get_preview/read_more_link">timber/post/get_preview/read_more_link</a></li><li><a href="#timber/site/update_option">timber/site/update_option</a></li><li><a href="#timber_site_set_meta">timber_site_set_meta</a></li><li><a href="#timber/term/link">timber/term/link</a></li><li><a href="#timber_term_link">timber_term_link</a></li><li><a href="#timber/term/path">timber/term/path</a></li><li><a href="#timber_term_path">timber_term_path</a></li><li><a href="#timber_term_set_meta">timber_term_set_meta</a></li><li><a href="#timber/term/meta/set">timber/term/meta/set</a></li><li><a href="#timber/trim_words/allowed_tags">timber/trim_words/allowed_tags</a></li><li><a href="#timber/integrations">timber/integrations</a></li><li><a href="#timber/context">timber/context</a></li><li><a href="#timber_context">timber_context</a></li><li><a href="#timber/render/file">timber/render/file</a></li><li><a href="#timber_render_file">timber_render_file</a></li><li><a href="#timber/compile/file">timber/compile/file</a></li><li><a href="#timber_compile_file">timber_compile_file</a></li><li><a href="#timber/render/data">timber/render/data</a></li><li><a href="#timber_render_data">timber_render_data</a></li><li><a href="#timber/compile/data">timber/compile/data</a></li><li><a href="#timber_compile_data">timber_compile_data</a></li><li><a href="#timber/compile/result">timber/compile/result</a></li><li><a href="#timber_compile_result">timber_compile_result</a></li><li><a href="#timber/twig/functions">timber/twig/functions</a></li><li><a href="#timber/twig/filters">timber/twig/filters</a></li><li><a href="#timber/twig/escapers">timber/twig/escapers</a></li><li><a href="#timber/url_helper/url_to_file_system/path">timber/url_helper/url_to_file_system/path</a></li><li><a href="#timber/urlhelper/url_to_file_system/path">timber/URLHelper/url_to_file_system/path</a></li><li><a href="#timber/url_helper/file_system_to_url">timber/url_helper/file_system_to_url</a></li><li><a href="#timber/urlhelper/file_system_to_url">timber/URLHelper/file_system_to_url</a></li><li><a href="#timber/url_helper/get_content_subdir/home_url">timber/url_helper/get_content_subdir/home_url</a></li><li><a href="#timber/urlhelper/get_content_subdir/home_url">timber/URLHelper/get_content_subdir/home_url</a></li><li><a href="#timber/url/schemes-whitelist">timber/url/schemes-whitelist</a></li><li><a href="#timber/user/name">timber/user/name</a></li></ol></nav></aside><div class="content"><h2 id="timber/meta/transform_value" tabindex="-1">timber/meta/transform_value <a class="directLink" href="#timber/meta/transform_value">#</a></h2><p>Filters whether to transform a meta value.</p><p>If the filter returns <code>true</code>, all meta value will be transformed to Timber/standard PHP objects if possible.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$transform_value</td><td><code>bool</code></td><td></td></tr></tbody></table><p><strong>PHP</strong></p><pre class="language-php"><code class="language-php"><span class="token comment">// Transforms all meta value.</span><br><span class="token function">add_filter</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'timber/meta/transform_value'</span><span class="token punctuation">,</span> <span class="token string single-quoted-string">'__return_true'</span> <span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h2 id="timber/{dollarobject_type}/pre_meta" tabindex="-1">timber/{$object_type}/pre_meta <a class="directLink" href="#timber/{dollarobject_type}/pre_meta">#</a></h2><p>Filters object meta data before it is fetched from the database.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$object_meta</td><td><code>string</code> or <code>null</code></td><td>The field value. Default null. Passing a non-null value will skip fetching the value from the database and will use the value from the filter instead.</td></tr><tr><td>$post_id</td><td><code>int</code></td><td>The post ID.</td></tr><tr><td>$field_name</td><td><code>string</code></td><td>The name of the meta field to get the value for.</td></tr><tr><td>$object</td><td><code>object</code></td><td>The Timber object.</td></tr><tr><td>$args</td><td><code>array</code></td><td>An array of arguments.</td></tr></tbody></table><p><strong>PHP</strong></p><pre class="language-php"><code class="language-php"><span class="token comment">// Disable fetching meta values.</span><br><span class="token function">add_filter</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'timber/post/pre_meta'</span><span class="token punctuation">,</span> <span class="token string single-quoted-string">'__return_false'</span> <span class="token punctuation">)</span><span class="token punctuation">;</span><br><br><span class="token comment">// Add your own meta data.</span><br><span class="token function">add_filter</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'timber/post/pre_meta'</span><span class="token punctuation">,</span> <span class="token keyword">function</span><span class="token punctuation">(</span> <span class="token variable">$post_meta</span><span class="token punctuation">,</span> <span class="token variable">$post_id</span><span class="token punctuation">,</span> <span class="token variable">$post</span> <span class="token punctuation">)</span> <span class="token punctuation">{</span><br>    <span class="token variable">$post_meta</span> <span class="token operator">=</span> <span class="token function">array_merge</span><span class="token punctuation">(</span> <span class="token variable">$post_meta</span><span class="token punctuation">,</span> <span class="token punctuation">[</span><br>        <span class="token string single-quoted-string">'custom_data_1'</span> <span class="token operator">=></span> <span class="token number">73</span><span class="token punctuation">,</span><br>        <span class="token string single-quoted-string">'custom_data_2'</span> <span class="token operator">=></span> <span class="token number">274</span><span class="token punctuation">,</span><br>    <span class="token punctuation">]</span> <span class="token punctuation">)</span><span class="token punctuation">;</span><br><br>    <span class="token keyword">return</span> <span class="token variable">$post_meta</span><span class="token punctuation">;</span><br><span class="token punctuation">}</span><span class="token punctuation">,</span> <span class="token number">10</span><span class="token punctuation">,</span> <span class="token number">3</span> <span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h2 id="timber_{dollarobject_type}_get_meta_field_pre" tabindex="-1">timber_{$object_type}_get_meta_field_pre <a class="directLink" href="#timber_{dollarobject_type}_get_meta_field_pre">#</a></h2><p>Filters the value for a post meta field before it is fetched from the database.</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/{object_type}/pre_meta</code></p><h2 id="timber/{dollarobject_type}/meta" tabindex="-1">timber/{$object_type}/meta <a class="directLink" href="#timber/{dollarobject_type}/meta">#</a></h2><p>Filters the value for a post meta field.</p><p>This filter is used by the ACF Integration.</p><p><strong>see</strong> <a href="/docs/reference/timber-post/#meta">Timber\Post::meta()</a></p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$post_meta</td><td><code>string</code></td><td>The field value.</td></tr><tr><td>$post_id</td><td><code>int</code></td><td>The post ID.</td></tr><tr><td>$field_name</td><td><code>string</code></td><td>The name of the meta field to get the value for.</td></tr><tr><td>$post</td><td><code>\CoreEntity</code></td><td>The post object.</td></tr><tr><td>$args</td><td><code>array</code></td><td>An array of arguments.</td></tr></tbody></table><p><strong>PHP</strong></p><pre class="language-php"><code class="language-php"><span class="token function">add_filter</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'timber/post/meta'</span><span class="token punctuation">,</span> <span class="token keyword">function</span><span class="token punctuation">(</span> <span class="token variable">$post_meta</span><span class="token punctuation">,</span> <span class="token variable">$post_id</span><span class="token punctuation">,</span> <span class="token variable">$field_name</span><span class="token punctuation">,</span> <span class="token variable">$post</span> <span class="token punctuation">)</span> <span class="token punctuation">{</span><br>    <span class="token keyword">if</span> <span class="token punctuation">(</span> <span class="token string single-quoted-string">'event'</span> <span class="token operator">===</span> <span class="token variable">$post</span><span class="token operator">-></span><span class="token property">post_type</span> <span class="token punctuation">)</span> <span class="token punctuation">{</span><br>        <span class="token comment">// Do something special.</span><br>        <span class="token variable">$post_meta</span><span class="token punctuation">[</span><span class="token string single-quoted-string">'foo'</span><span class="token punctuation">]</span> <span class="token operator">=</span> <span class="token variable">$post_meta</span><span class="token punctuation">[</span><span class="token string single-quoted-string">'foo'</span><span class="token punctuation">]</span> <span class="token operator">.</span> <span class="token string single-quoted-string">' bar'</span><span class="token punctuation">;</span><br>    <span class="token punctuation">}</span><br><br>    <span class="token keyword">return</span> <span class="token variable">$post_meta</span><span class="token punctuation">;</span><br><span class="token punctuation">}</span><span class="token punctuation">,</span> <span class="token number">10</span><span class="token punctuation">,</span> <span class="token number">4</span> <span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h2 id="timber/term/meta/field" tabindex="-1">timber/term/meta/field <a class="directLink" href="#timber/term/meta/field">#</a></h2><p>Filters the value for a term meta field.</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/term/meta</code></p><h2 id="timber_{dollarobject_type}_get_meta_field" tabindex="-1">timber_{$object_type}_get_meta_field <a class="directLink" href="#timber_{dollarobject_type}_get_meta_field">#</a></h2><p>Filters the value for an object meta field.</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/{object_type}/meta</code></p><h2 id="timber_{dollarobject_type}_get_meta" tabindex="-1">timber_{$object_type}_get_meta <a class="directLink" href="#timber_{dollarobject_type}_get_meta">#</a></h2><p>Filters object meta data fetched from the database.</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/{object_type}/meta</code></p><h2 id="timber/comment/classmap" tabindex="-1">timber/comment/classmap <a class="directLink" href="#timber/comment/classmap">#</a></h2><p>Filters the class(es) used for comments linked to different post types.</p><p>The default class is Timber\Comment. You can use this filter to provide your own comment class for specific post types.</p><p>Make sure to merge in your additional classes instead of overwriting the whole Class Map.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$classmap</td><td><code>array</code></td><td>The post class(es) to use. An associative array where the key is the post type and the value the name of the class to use for the comments of this post type or a callback that determines the class to use.</td></tr></tbody></table><pre><code>use Book;
+
+add_filter( 'timber/post/classmap', function( $classmap ) {
+    $custom_classmap = [
+        'book' =&gt; BookComment::class,
+    ];
+
+    return array_merge( $classmap, $custom_classmap );
+} );
+</code></pre><h2 id="timber/comment/class" tabindex="-1">timber/comment/class <a class="directLink" href="#timber/comment/class">#</a></h2><p>Filters the comment class based on your custom criteria.</p><p>Maybe you want to set a custom class based upon the comment type? This allows you to filter the PHP class, utilizing data from the WP_Comment object.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$class</td><td><code>string</code></td><td>The class to use.</td></tr><tr><td>$comment</td><td><code>\WP_Comment</code></td><td>The comment object.</td></tr></tbody></table><pre><code>add_filter( 'timber/comment/class', function( $class, $comment ) {
+    if ( $comment-&gt;comment_type === 'pingback' ) {
+        return PingBackComment::class;
+    }
+    return $class;
+}, 10, 2 );
+</code></pre><h2 id="timber/menu/classmap" tabindex="-1">timber/menu/classmap <a class="directLink" href="#timber/menu/classmap">#</a></h2><p>Filters the class(es) used for different menus.</p><p>Read more about this in the documentation for <a href="https://timber.github.io/docs/v2/guides/class-maps/#the-menu-class-map">Menu Class Maps</a>.</p><p>The default Menu Class Map will contain class names for locations that map to <code>Timber\Menu</code>.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$classmap</td><td><code>array</code></td><td>The menu class(es) to use. An associative array where the key is the location and the value the name of the class to use for this menu or a callback that determines the class to use.</td></tr></tbody></table><pre><code>add_filter( 'timber/menu/classmap', function( $classmap ) {
+    $custom_classmap = [
+        'primary'   =&gt; MenuPrimary::class,
+        'secondary' =&gt; MenuSecondary::class,
+    ];
+
+    return array_merge( $classmap, $custom_classmap );
+} );
+</code></pre><h2 id="timber/menu/class" tabindex="-1">timber/menu/class <a class="directLink" href="#timber/menu/class">#</a></h2><p>Filters the menu class based on your custom criteria.</p><p>Maybe the location is not appropriate in some cases. This filter will allow you to filter the class on whatever data is available.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$class</td><td><code>string</code></td><td>The class to use.</td></tr><tr><td>$term</td><td><code>\WP_Term</code></td><td>The menu term.</td></tr><tr><td>$args</td><td><code>array</code></td><td>The arguments passed to the menu.</td></tr></tbody></table><pre><code>add_filter( 'timber/menu/class', function( $class, $term, $args ) {
+    if ( $args['depth'] === 1 ) {
+        return SingleLevelMenu::class;
+    }
+
+    return MultiLevelMenu::class;
+}, 10, 3 );
+</code></pre><h2 id="timber/menuitem/classmap" tabindex="-1">timber/menuitem/classmap <a class="directLink" href="#timber/menuitem/classmap">#</a></h2><p>Filters the class(es) used for different menu items.</p><p>Read more about this in the documentation for <a href="https://timber.github.io/docs/v2/guides/class-maps/#the-menu-item-class-map">Menu Item Class Maps</a>.</p><p>The default Menu Item Class Map will contain class names for locations that map to <code>Timber\MenuItem</code>.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$classmap</td><td><code>array</code></td><td>The menu item class(es) to use. An associative array where the key is the location and the value the name of the class to use for this menu item or a callback that determines the class to use.</td></tr></tbody></table><pre><code>add_filter( 'timber/menuitem/classmap', function( $classmap ) {
+    $custom_classmap = [
+        'primary'   =&gt; MenuItemFooter::class,
+        'secondary' =&gt; MenuItemHeader::class,
+    ];
+
+    return array_merge( $classmap, $custom_classmap );
+} );
+</code></pre><h2 id="timber/menuitem/class" tabindex="-1">timber/menuitem/class <a class="directLink" href="#timber/menuitem/class">#</a></h2><p>Filters the menu item class</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$class</td><td><code>string</code></td><td>The class to use.</td></tr><tr><td>$item</td><td><code>\WP_Post</code></td><td>The menu item.</td></tr><tr><td>$menu</td><td><code>\Menu</code></td><td>The menu object.</td></tr></tbody></table><pre><code>add_filter( 'timber/menuitem/class', function( $class, $item, $menu ) {
+    if ( $item-&gt;post_parent ) {
+        return SubMenuItem::class;
+    }
+
+    return MenuItem::class;
+}, 10, 3 );
+</code></pre><h2 id="timber/pages_menu/class" tabindex="-1">timber/pages_menu/class <a class="directLink" href="#timber/pages_menu/class">#</a></h2><p>Filters the class used for different menus.</p><p>Read more about this in the documentation for <a href="https://timber.github.io/docs/v2/guides/class-maps/#the-pages-menu-class-filter">Pages Menu Class filter</a>.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$class</td><td><code>string</code></td><td>The pages menu class to use.</td></tr><tr><td>$args</td><td><code>array</code></td><td>The arguments passed to <code>Timber::get_pages_menu()</code>.</td></tr></tbody></table><pre><code>add_filter( 'timber/pages_menu/class', function( $class ) {
+    return ExtendedPagesMenu::class;
+} );
+</code></pre><h2 id="timber/post/classmap" tabindex="-1">timber/post/classmap <a class="directLink" href="#timber/post/classmap">#</a></h2><p>Filters the class(es) used for different post types.</p><p>Read more about this in the documentation for <a href="https://timber.github.io/docs/v2/guides/class-maps/#the-post-class-map">Post Class Maps</a>.</p><p>The default Post Class Map will contain class names for posts, pages that map to <code>Timber\Post</code> and a callback that will map attachments to <code>Timber\Attachment</code> and attachments that are images to <code>Timber\Image</code>.</p><p>Make sure to merge in your additional classes instead of overwriting the whole Class Map.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$classmap</td><td><code>array</code></td><td>The post class(es) to use. An associative array where the key is the post type and the value the name of the class to use for this post type or a callback that determines the class to use.</td></tr></tbody></table><pre><code>use Book;
+use Page;
+
+add_filter( 'timber/post/classmap', function( $classmap ) {
+    $custom_classmap = [
+        'page' =&gt; Page::class,
+        'book' =&gt; Book::class,
+    ];
+
+    return array_merge( $classmap, $custom_classmap );
+} );
+</code></pre><h2 id="timber/post/class" tabindex="-1">timber/post/class <a class="directLink" href="#timber/post/class">#</a></h2><p>Filters the post class based on your custom criteria.</p><p>Maybe you want to set a custom class based upon how blocks are used? This allows you to filter the PHP class, utilizing data from the WP_Post object.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$class</td><td><code>string</code></td><td>The class to use.</td></tr><tr><td>$post</td><td><code>\WP_Post</code></td><td>The post object.</td></tr></tbody></table><pre><code>add_filter( 'timber/post/class', function( $class, $post ) {
+    if ( has_blocks($post) ) {
+        return GutenbergPost::class;
+    }
+
+    return $class;
+}, 10, 2 );
+</code></pre><h2 id="timber/post/image_extensions" tabindex="-1">timber/post/image_extensions <a class="directLink" href="#timber/post/image_extensions">#</a></h2><p>Filters the list of image extensions that will be used to determine if an attachment is an image.</p><p>You can use this filter to add or remove image extensions to the list of extensions that will be used to determine if an attachment is an image.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$extensions</td><td><code>array</code></td><td>An array of image extensions.</td></tr></tbody></table><h2 id="timber/term/classmap" tabindex="-1">timber/term/classmap <a class="directLink" href="#timber/term/classmap">#</a></h2><p>Filters the class(es) used for terms of different taxonomies.</p><p>The default Term Class Map will contain class names mapped to the build-in post_tag and category taxonomies.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$classmap</td><td><code>array</code></td><td>The term class(es) to use. An associative array where the key is the taxonomy name and the value the name of the class to use for this taxonomy or a callback that determines the class to use.</td></tr></tbody></table><pre><code>add_filter( 'timber/term/classmap', function( $classmap ) {
+    $custom_classmap = [
+        'expertise'   =&gt; ExpertiseTerm::class,
+    ];
+
+    return array_merge( $classmap, $custom_classmap );
+} );
+</code></pre><h2 id="timber/term/class" tabindex="-1">timber/term/class <a class="directLink" href="#timber/term/class">#</a></h2><p>Filters the term class based on your custom criteria.</p><p>Maybe you want to set a custom class based upon a certain category? This allows you to filter the PHP class, utilizing data from the WP_Term object.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$class</td><td><code>string</code></td><td>The class to use.</td></tr><tr><td>$term</td><td><code>\WP_Term</code></td><td>The term object.</td></tr></tbody></table><pre><code>add_filter( 'timber/term/class', function( $class, $term ) {
+    if ( get_term_meta($term-&gt;term_id, 'is_special_category', true) ) {
+        return MyCustomTermClass::class;
+    }
+
+    return $class;
+}, 10, 2 );
+</code></pre><h2 id="timber/user/class" tabindex="-1">timber/user/class <a class="directLink" href="#timber/user/class">#</a></h2><p>Filters the name of the PHP class used to instantiate <code>Timber\User</code> objects.</p><p>The User Class Map receives the default <code>Timber\User</code> class and a <code>WP_User</code> object. You should be able to decide which class to use based on that user object.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$class</td><td><code>string</code></td><td>The name of the class. Default <code>Timber\User</code>.</td></tr><tr><td>$user</td><td><code>\WP_User</code></td><td>The <code>WP_User</code> object that is used as the base for the <code>Timber\User</code> object.</td></tr></tbody></table><p><strong>PHP</strong></p><pre class="language-php"><code class="language-php"><span class="token keyword">use</span> <span class="token package">Administrator</span><span class="token punctuation">;</span><br><span class="token keyword">use</span> <span class="token package">Editor</span><span class="token punctuation">;</span><br><br><span class="token function">add_filter</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'timber/user/class'</span><span class="token punctuation">,</span> <span class="token keyword">function</span><span class="token punctuation">(</span> <span class="token variable">$class</span><span class="token punctuation">,</span> <span class="token class-name class-name-fully-qualified type-declaration"><span class="token punctuation">\</span>WP_User</span> <span class="token variable">$user</span> <span class="token punctuation">)</span> <span class="token punctuation">{</span><br>    <span class="token keyword">if</span> <span class="token punctuation">(</span> <span class="token function">in_array</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'editor'</span><span class="token punctuation">,</span> <span class="token variable">$user</span><span class="token operator">-></span><span class="token property">roles</span><span class="token punctuation">,</span> <span class="token constant boolean">true</span> <span class="token punctuation">)</span> <span class="token punctuation">)</span> <span class="token punctuation">{</span><br>        <span class="token keyword">return</span> <span class="token class-name static-context">Editor</span><span class="token operator">::</span><span class="token keyword">class</span><span class="token punctuation">;</span><br>    <span class="token punctuation">}</span> <span class="token keyword">elseif</span> <span class="token punctuation">(</span> <span class="token function">in_array</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'author'</span><span class="token punctuation">,</span> <span class="token variable">$user</span><span class="token operator">-></span><span class="token property">roles</span><span class="token punctuation">,</span> <span class="token constant boolean">true</span> <span class="token punctuation">)</span> <span class="token punctuation">)</span> <span class="token punctuation">{</span><br>        <span class="token keyword">return</span> <span class="token class-name static-context">Author</span><span class="token operator">::</span><span class="token keyword">class</span><span class="token punctuation">;</span><br>    <span class="token punctuation">}</span><br><br>    <span class="token keyword">return</span> <span class="token variable">$class</span><span class="token punctuation">;</span><br><span class="token punctuation">}</span><span class="token punctuation">,</span> <span class="token number">10</span><span class="token punctuation">,</span> <span class="token number">2</span> <span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h2 id="timber/transient/slug" tabindex="-1">timber/transient/slug <a class="directLink" href="#timber/transient/slug">#</a></h2><p>Filters the transient slug.</p><p>This might be useful if you are using a multilingual solution.</p><p><strong>since</strong> 0.22.6</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$slug</td><td><code>string</code></td><td>The slug for the transient.</td></tr></tbody></table><h2 id="timber/transient/force_transients" tabindex="-1">timber/transient/force_transients <a class="directLink" href="#timber/transient/force_transients">#</a></h2><p>Filters whether to force a locked transients to be regenerated.</p><p>If a transient is locked, it means that another process is currently generating the data. If you want to force the transient to be regenerated, during that process, you can set this filter to true.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$force</td><td><code>bool</code></td><td>Whether to force a locked transient to be regenerated.</td></tr></tbody></table><h2 id="timber_force_transients" tabindex="-1">timber_force_transients <a class="directLink" href="#timber_force_transients">#</a></h2><p>Filters whether to force a locked transients to be regenerated.</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/transient/force_transients</code></p><p>If a transient is locked, it means that another process is currently generating the data. If you want to force the transient to be regenerated, during that process, you can set this filter to true.</p><h2 id="timber/transient/force_transient_{dollarslug}" tabindex="-1">timber/transient/force_transient_{$slug} <a class="directLink" href="#timber/transient/force_transient_{dollarslug}">#</a></h2><p>Filters whether to force a specific locked transients to be regenerated.</p><p>If a transient is locked, it means that another process is currently generating the data. If you want to force the transient to be regenerated during that process, you can set this value to true.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$force</td><td><code>bool</code></td><td>Whether to force a locked transient to be regenerated.</td></tr></tbody></table><p><strong>PHP</strong></p><pre class="language-php"><code class="language-php"><br><span class="token function">add_filter</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'timber/transient/force_transient_mycustumslug'</span><span class="token punctuation">,</span> <span class="token keyword">function</span><span class="token punctuation">(</span><span class="token variable">$force</span><span class="token punctuation">)</span> <span class="token punctuation">{</span><br>    <span class="token keyword">if</span><span class="token punctuation">(</span><span class="token constant boolean">false</span> <span class="token operator">==</span> <span class="token function">something_special_has_occurred</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">)</span><span class="token punctuation">{</span><br>      <span class="token keyword">return</span> <span class="token constant boolean">false</span><span class="token punctuation">;</span><br>    <span class="token punctuation">}</span><br><br>    <span class="token keyword">return</span> <span class="token constant boolean">true</span><span class="token punctuation">;</span><br><span class="token punctuation">}</span><span class="token punctuation">,</span> <span class="token number">10</span> <span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h2 id="timber_force_transient_{dollarslug}" tabindex="-1">timber_force_transient_{$slug} <a class="directLink" href="#timber_force_transient_{dollarslug}">#</a></h2><p>Filters whether to force a specific locked transients to be regenerated.</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/transient/force_transient_{$slug}</code></p><p>If a transient is locked, it means that another process is currently generating the data. If you want to force the transient to be regenerated, during that process, you can set this value to true. <code>$slug</code> The transient slug.</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$force</td><td><code>bool</code></td><td>Whether to force a locked transient to be regenerated.</td></tr></tbody></table><h2 id="timber/helper/wp_title_separator" tabindex="-1">timber/helper/wp_title_separator <a class="directLink" href="#timber/helper/wp_title_separator">#</a></h2><p>Filters the separator used for the page title.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$separator</td><td><code>string</code></td><td>The separator to use. Default <code>' '</code>.</td></tr></tbody></table><h2 id="timber_wp_title_seperator" tabindex="-1">timber_wp_title_seperator <a class="directLink" href="#timber_wp_title_seperator">#</a></h2><p>Filters the separator used for the page title.</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/helper/wp_title_separator</code></p><h2 id="timber/image/src" tabindex="-1">timber/image/src <a class="directLink" href="#timber/image/src">#</a></h2><p>Filters the src URL for a <code>Timber\Image</code>.</p><p><strong>see</strong> <a href="/docs/reference/timber-image/#src">Timber\Image::src()</a></p><p><strong>since</strong> 0.21.7</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$src</td><td><code>string</code></td><td>The image src.</td></tr><tr><td>$id</td><td><code>int</code></td><td>The image ID.</td></tr></tbody></table><h2 id="timber_image_src" tabindex="-1">timber_image_src <a class="directLink" href="#timber_image_src">#</a></h2><p>Filters the src URL for a <code>Timber\Image</code>.</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/image/src</code></p><h2 id="timber/sideload_image/basename" tabindex="-1">timber/sideload_image/basename <a class="directLink" href="#timber/sideload_image/basename">#</a></h2><p>Filters basename for sideloaded files.</p><p><strong>since</strong> 2.1.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$basename</td><td><code>string</code></td><td>Current basename for the sideloaded file.</td></tr><tr><td>$path_parts</td><td><code>array</code></td><td>Array with path info for the sideloaded file.</td></tr></tbody></table><p><strong>PHP</strong></p><pre class="language-php"><code class="language-php"><span class="token comment">// Change the basename used for sideloaded images.</span><br><span class="token function">add_filter</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'timber/sideload_image/basename'</span><span class="token punctuation">,</span> <span class="token keyword">function</span> <span class="token punctuation">(</span><span class="token variable">$basename</span><span class="token punctuation">,</span> <span class="token variable">$path_parts</span><span class="token punctuation">)</span> <span class="token punctuation">{</span><br>    <span class="token keyword">return</span> <span class="token variable">$path_parts</span><span class="token punctuation">[</span><span class="token string single-quoted-string">'filename'</span><span class="token punctuation">]</span> <span class="token operator">.</span> <span class="token string single-quoted-string">'-'</span> <span class="token operator">.</span> <span class="token function">substr</span><span class="token punctuation">(</span><span class="token variable">$basename</span><span class="token punctuation">,</span> <span class="token number">0</span><span class="token punctuation">,</span> <span class="token number">6</span><span class="token punctuation">)</span><span class="token punctuation">;</span><br><span class="token punctuation">}</span><span class="token punctuation">,</span> <span class="token number">10</span><span class="token punctuation">,</span> <span class="token number">2</span><span class="token punctuation">)</span></code></pre><h2 id="timber/sideload_image/subdir" tabindex="-1">timber/sideload_image/subdir <a class="directLink" href="#timber/sideload_image/subdir">#</a></h2><p>Filters to directory that should be used for sideloaded images.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$subdir</td><td><code>string</code></td><td>The subdir name to use for sideloaded images. Return an empty string or a falsey value in order to not use a subfolder. Default <code>external</code>.</td></tr></tbody></table><p><strong>PHP</strong></p><pre class="language-php"><code class="language-php"><span class="token comment">// Change the subdirectory used for sideloaded images.</span><br><span class="token function">add_filter</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'timber/sideload_image/subdir'</span><span class="token punctuation">,</span> <span class="token keyword">function</span><span class="token punctuation">(</span> <span class="token variable">$subdir</span> <span class="token punctuation">)</span> <span class="token punctuation">{</span><br>    <span class="token keyword">return</span> <span class="token string single-quoted-string">'sideloaded'</span><span class="token punctuation">;</span><br><span class="token punctuation">}</span> <span class="token punctuation">)</span><span class="token punctuation">;</span><br><br><span class="token comment">// Disable subdirectory used for sideloaded images.</span><br><span class="token function">add_filter</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'timber/sideload_image/subdir'</span><span class="token punctuation">,</span> <span class="token string single-quoted-string">'__return_false'</span> <span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h2 id="timber/image_helper/pre_analyze_url" tabindex="-1">timber/image_helper/pre_analyze_url <a class="directLink" href="#timber/image_helper/pre_analyze_url">#</a></h2><p>Filters whether to short-circuit the ImageHelper::analyze_url() file path of a URL located in a theme directory.</p><p>Returning a non-null value from the filter will short-circuit ImageHelper::analyze_url(), returning that value.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$info</td><td><code>array&lt;string,mixed&gt;</code> or <code>null</code></td><td>The URL components array to short-circuit with. Default null.</td></tr><tr><td>$url</td><td><code>string</code></td><td>The URL pointing to an image.</td></tr></tbody></table><h2 id="timber/image_helper/analyze_url" tabindex="-1">timber/image_helper/analyze_url <a class="directLink" href="#timber/image_helper/analyze_url">#</a></h2><p>Filters the array of analyzed URL components.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$info</td><td><code>array&lt;string,mixed&gt;</code></td><td>The URL components.</td></tr><tr><td>$url</td><td><code>string</code></td><td>The URL pointing to an image.</td></tr></tbody></table><h2 id="timber/image_helper/pre_theme_url_to_dir" tabindex="-1">timber/image_helper/pre_theme_url_to_dir <a class="directLink" href="#timber/image_helper/pre_theme_url_to_dir">#</a></h2><p>Filters whether to short-circuit the ImageHelper::theme_url_to_dir() file path of a URL located in a theme directory.</p><p>Returning a non-null value from the filter will short-circuit ImageHelper::theme_url_to_dir(), returning that value.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$path</td><td><code>string</code> or <code>null</code></td><td>Full path to short-circuit with. Default null.</td></tr><tr><td>$src</td><td><code>string</code></td><td>The URL to be converted.</td></tr></tbody></table><h2 id="timber/image_helper/theme_url_to_dir" tabindex="-1">timber/image_helper/theme_url_to_dir <a class="directLink" href="#timber/image_helper/theme_url_to_dir">#</a></h2><p>Filters the raw file path of a URL located in a theme directory.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$path</td><td><code>string</code></td><td>The resolved full path to $src.</td></tr><tr><td>$src</td><td><code>string</code></td><td>The URL that was converted.</td></tr></tbody></table><h2 id="timber/image/new_url" tabindex="-1">timber/image/new_url <a class="directLink" href="#timber/image/new_url">#</a></h2><p>Filters the URL for the resized version of a <code>Timber\Image</code>.</p><p>You’ll probably need to use this in combination with <code>timber/image/new_path</code>.</p><p><strong>since</strong> 1.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$new_url</td><td><code>string</code></td><td>The URL to the resized version of an image.</td></tr></tbody></table><h2 id="timber/image/new_path" tabindex="-1">timber/image/new_path <a class="directLink" href="#timber/image/new_path">#</a></h2><p>Filters the destination path for the resized version of a <code>Timber\Image</code>.</p><p>A possible use case for this would be to store all images generated by Timber in a separate directory. You’ll probably need to use this in combination with <code>timber/image/new_url</code>.</p><p><strong>since</strong> 1.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$destination_path</td><td><code>string</code></td><td>Full path to the destination of a resized image.</td></tr></tbody></table><h2 id="timber/cache/mode" tabindex="-1">timber/cache/mode <a class="directLink" href="#timber/cache/mode">#</a></h2><p>Filters the cache mode.</p><p>You can read more about Caching in the [Performance/Caching]({{&lt;relref &quot;<a href="http://performance.md">performance.md</a>&quot; &gt;}}) guide.</p><p><strong>since</strong> 0.20.10</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$cache_mode</td><td><code>string</code></td><td>The cache mode. Can be one of the following: <code>Timber\Loader::CACHE_NONE</code>, <code>Timber\Loader::CACHE_OBJECT</code>, <code>Timber\Loader::CACHE_TRANSIENT</code>, <code>Timber\Loader::CACHE_SITE_TRANSIENT</code>, <code>Timber\Loader::CACHE_USE_DEFAULT</code>. Default <code>Timber\Loader::CACHE_TRANSIENT</code>.</td></tr></tbody></table><h2 id="timber_cache_mode" tabindex="-1">timber_cache_mode <a class="directLink" href="#timber_cache_mode">#</a></h2><p>Filters the cache mode.</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/cache/mode</code></p><h2 id="timber/loader/render_data" tabindex="-1">timber/loader/render_data <a class="directLink" href="#timber/loader/render_data">#</a></h2><p>Filters …</p><p><strong>since</strong> 0.20.10</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$data</td><td><code>array</code></td><td></td></tr><tr><td>$file</td><td><code>string</code></td><td></td></tr></tbody></table><h2 id="timber_loader_render_data" tabindex="-1">timber_loader_render_data <a class="directLink" href="#timber_loader_render_data">#</a></h2><p>Filters …</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/loader/render_data</code></p><h2 id="timber/output/pre-cache" tabindex="-1">timber/output/pre-cache <a class="directLink" href="#timber/output/pre-cache">#</a></h2><p>Filters $output before it is cached.</p><p><strong>since</strong> 2.1.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$output</td><td><code>string</code></td><td></td></tr><tr><td>$data</td><td><code>array</code></td><td></td></tr><tr><td>$file</td><td><code>string</code></td><td></td></tr></tbody></table><h2 id="timber/output" tabindex="-1">timber/output <a class="directLink" href="#timber/output">#</a></h2><p>Filters …</p><p><strong>since</strong> 0.20.10</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$output</td><td><code>string</code></td><td></td></tr><tr><td>$data</td><td><code>array</code></td><td></td></tr><tr><td>$file</td><td><code>string</code></td><td></td></tr></tbody></table><h2 id="timber_output" tabindex="-1">timber_output <a class="directLink" href="#timber_output">#</a></h2><p>Filters …</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/output</code></p><h2 id="timber/loader/paths" tabindex="-1">timber/loader/paths <a class="directLink" href="#timber/loader/paths">#</a></h2><p>Filters the template paths used by the Loader.</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/locations</code></p><p><strong>since</strong> 0.20.10</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$paths</td><td><code>array</code></td><td></td></tr></tbody></table><h2 id="timber/loader/loader" tabindex="-1">timber/loader/loader <a class="directLink" href="#timber/loader/loader">#</a></h2><p>Filters …</p><p><strong>link</strong> <a href="https://github.com/timber/timber/pull/1254">https://github.com/timber/timber/pull/1254</a></p><p><strong>since</strong> 1.1.11</p><h2 id="timber/twig/environment/options" tabindex="-1">timber/twig/environment/options <a class="directLink" href="#timber/twig/environment/options">#</a></h2><p>Filters the environment options that are used when creating a Twig Environment instance.</p><p>By default, Timber sets the following values:</p><ul><li><code>'debug' =&gt; WP_DEBUG</code></li><li><code>'autoescape' =&gt; false</code></li><li><code>'cache' =&gt; false</code></li></ul><p><strong>link</strong> <a href="https://twig.symfony.com/doc/2.x/api.html#environment-options">https://twig.symfony.com/doc/2.x/api.html#environment-options</a></p><p><strong>since</strong> 1.9.5</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$environment_options</td><td><code>array</code></td><td>An array of Twig environment options.</td></tr></tbody></table><p><strong>PHP</strong></p><pre class="language-php"><code class="language-php"><span class="token function">add_filter</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'timber/twig/environment/options'</span><span class="token punctuation">,</span> <span class="token string single-quoted-string">'update_twig_environment_options'</span> <span class="token punctuation">)</span><span class="token punctuation">;</span><br><br><span class="token comment">/**<br> * Updates Twig environment options.<br> *<br> * @link https://twig.symfony.com/doc/2.x/api.html#environment-options<br> *<br> * \@param array $options An array of environment options.<br> *<br> * @return array<br> */</span><br><span class="token keyword">function</span> <span class="token function-definition function">update_twig_environment_options</span><span class="token punctuation">(</span> <span class="token variable">$options</span> <span class="token punctuation">)</span> <span class="token punctuation">{</span><br>    <span class="token variable">$options</span><span class="token punctuation">[</span><span class="token string single-quoted-string">'cache'</span><span class="token punctuation">]</span>       <span class="token operator">=</span> <span class="token constant boolean">true</span><span class="token punctuation">;</span><br>    <span class="token variable">$options</span><span class="token punctuation">[</span><span class="token string single-quoted-string">'auto_reload'</span><span class="token punctuation">]</span> <span class="token operator">=</span> <span class="token constant boolean">true</span><span class="token punctuation">;</span><br><br>    <span class="token keyword">return</span> <span class="token variable">$options</span><span class="token punctuation">;</span><br><span class="token punctuation">}</span></code></pre><h2 id="timber/cache/location" tabindex="-1">timber/cache/location <a class="directLink" href="#timber/cache/location">#</a></h2><p>Filters the cache location used for Twig.</p><p><strong>DEPRECATED</strong> since 2.0.0</p><p>Allows you to set a new cache location for Twig. If the folder doesn’t exist yet, it will be created automatically.</p><p><strong>since</strong> 0.20.10</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$twig_cache_loc</td><td><code>string</code></td><td>Full path to the cache location. Default <code>/cache/twig</code> in the Timber root folder.</td></tr></tbody></table><h2 id="timber/cache/enable_extension" tabindex="-1">timber/cache/enable_extension <a class="directLink" href="#timber/cache/enable_extension">#</a></h2><p>Filters the cache extension activation.</p><p>Allows users to disable the cache extension and use their own</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$enable_cache_extension</td><td><code>bool</code></td><td>Whether to enable the cache extension.</td></tr></tbody></table><h2 id="timber/loader/twig" tabindex="-1">timber/loader/twig <a class="directLink" href="#timber/loader/twig">#</a></h2><p>Filters …</p><p><strong>since</strong> 0.20.10</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$twig</td><td><code>\Environment</code></td><td>The Twig environment you can add functionality to.</td></tr></tbody></table><h2 id="timber/twig" tabindex="-1">timber/twig <a class="directLink" href="#timber/twig">#</a></h2><p>Filters the Twig environment used in the global context.</p><p>You can use this filter if you want to add additional functionality to Twig, like global variables, filters or functions.</p><p><strong>since</strong> 0.21.9</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$twig</td><td><code>\Environment</code></td><td>The Twig environment.</td></tr></tbody></table><p><strong>PHP</strong></p><pre class="language-php"><code class="language-php"><span class="token comment">/**<br> * Adds Twig functionality.<br> *<br> * \@param \Twig\Environment $twig The Twig Environment to which you can add additional functionality.<br> */</span><br><span class="token function">add_filter</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'timber/twig'</span><span class="token punctuation">,</span> <span class="token keyword">function</span><span class="token punctuation">(</span> <span class="token variable">$twig</span> <span class="token punctuation">)</span> <span class="token punctuation">{</span><br>    <span class="token comment">// Make get_theme_file_uri() usable as {{ theme_file() }} in Twig.</span><br>    <span class="token variable">$twig</span><span class="token operator">-></span><span class="token function">addFunction</span><span class="token punctuation">(</span> <span class="token keyword">new</span> <span class="token class-name class-name-fully-qualified">Twig<span class="token punctuation">\</span>TwigFunction</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'theme_file'</span><span class="token punctuation">,</span> <span class="token string single-quoted-string">'get_theme_file_uri'</span> <span class="token punctuation">)</span> <span class="token punctuation">)</span><span class="token punctuation">;</span><br><br>    <span class="token keyword">return</span> <span class="token variable">$twig</span><span class="token punctuation">;</span><br><span class="token punctuation">}</span> <span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><p><strong>Twig</strong></p><pre class="language-twig"><code class="language-twig"><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>a</span> <span class="token attr-name">class</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>navbar-brand<span class="token punctuation">"</span></span> <span class="token attr-name">href</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span><span class="token twig language-twig"><span class="token delimiter punctuation">{{</span> site<span class="token punctuation">.</span>url <span class="token delimiter punctuation">}}</span></span><span class="token punctuation">"</span></span><span class="token punctuation">></span></span><br>    <span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>img</span> <span class="token attr-name">src</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span><span class="token twig language-twig"><span class="token delimiter punctuation">{{</span> theme_file<span class="token punctuation">(</span> <span class="token string"><span class="token punctuation">'</span>build/img/logo-example.svg<span class="token punctuation">'</span></span> <span class="token punctuation">)</span> <span class="token delimiter punctuation">}}</span></span><span class="token punctuation">"</span></span> <span class="token attr-name">alt</span><span class="token attr-value"><span class="token punctuation attr-equals">=</span><span class="token punctuation">"</span>Logo <span class="token twig language-twig"><span class="token delimiter punctuation">{{</span> site<span class="token punctuation">.</span>title <span class="token delimiter punctuation">}}</span></span><span class="token punctuation">"</span></span><span class="token punctuation">></span></span><br><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>a</span><span class="token punctuation">></span></span></code></pre><h2 id="timber/cache/extension/lifetime" tabindex="-1">timber/cache/extension/lifetime <a class="directLink" href="#timber/cache/extension/lifetime">#</a></h2><p>Filters the Twig environment used in the global context.</p><p><strong>DEPRECATED</strong> since 2.0.0</p><h2 id="timber/cache/transient_key" tabindex="-1">timber/cache/transient_key <a class="directLink" href="#timber/cache/transient_key">#</a></h2><p>Filters the transient key used for caching.</p><p><strong>since</strong> 2.1.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$trans_key</td><td><code>string</code></td><td>The transient key.</td></tr><tr><td>$key</td><td><code>string</code></td><td>The cache key.</td></tr><tr><td>$group</td><td><code>string</code></td><td>The cache group.</td></tr><tr><td>$cache_mode</td><td><code>string</code></td><td>The cache mode.</td></tr></tbody></table><pre><code>add_filter( 'timber/cache/transient_key', function( $trans_key, $key, $group, $cache_mode ) {
+    return $trans_key . '_my_suffix';
+}, 10, 4 );
+</code></pre><h2 id="timber/cache/transient_key-1" tabindex="-1">timber/cache/transient_key <a class="directLink" href="#timber/cache/transient_key-1">#</a></h2><p>Filters the transient key used for caching.</p><p><strong>since</strong> 2.1.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$trans_key</td><td><code>string</code></td><td>The transient key.</td></tr><tr><td>$key</td><td><code>string</code></td><td>The cache key.</td></tr><tr><td>$group</td><td><code>string</code></td><td>The cache group.</td></tr><tr><td>$cache_mode</td><td><code>string</code></td><td>The cache mode.</td></tr></tbody></table><pre><code>add_filter( 'timber/cache/transient_key', function( $trans_key, $key, $group, $cache_mode ) {
+    return $trans_key . '_my_suffix';
+}, 10, 4 );
+</code></pre><h2 id="timber/locations" tabindex="-1">timber/locations <a class="directLink" href="#timber/locations">#</a></h2><p>Filters the filesystem paths to search for Twig templates.</p><p><strong>since</strong> 0.20.10</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$locs</td><td><code>array</code></td><td>An array of filesystem paths to search for Twig templates.</td></tr></tbody></table><pre><code>add_filter( 'timber/locations', function( $locs ) {
+  $locs = \array_map(function ($loc) {
+     \array_unshift($loc, \dirname(__DIR__) . '/my-custom-dir');
+      return $loc;
+  }, $locs);
+
+    return $locs;
+} );
+</code></pre><h2 id="timber_locations" tabindex="-1">timber_locations <a class="directLink" href="#timber_locations">#</a></h2><p>Filters the filesystem paths to search for Twig templates.</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/locations</code></p><h2 id="timber/menu/item_objects" tabindex="-1">timber/menu/item_objects <a class="directLink" href="#timber/menu/item_objects">#</a></h2><p>Filters the sorted list of menu item objects before creating the Menu object.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$item</td><td><code>array</code></td><td></td></tr><tr><td>$menu</td><td><code>\WP_Term</code></td><td></td></tr></tbody></table><pre><code>add_filter( 'timber/menu/item_objects', function ( $items ) {
+    return array_map(function ($item) {
+        if ( is_object( $item ) &amp;&amp; ! ( $item instanceof \WP_Post ) ) {
+            return new \WP_Post( get_object_vars( $item ) );
+        }
+
+        return $item;
+    }, $items);
+} );
+</code></pre><h2 id="timber/post/import_data" tabindex="-1">timber/post/import_data <a class="directLink" href="#timber/post/import_data">#</a></h2><p>Filters the imported post data.</p><p>Used internally for previews.</p><p><strong>see</strong> Timber::init()</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$data</td><td><code>array</code></td><td>An array of post data to import.</td></tr><tr><td>$post</td><td><code>\Post</code></td><td>The Timber post instance.</td></tr></tbody></table><h2 id="timber/post/meta_object_field" tabindex="-1">timber/post/meta_object_field <a class="directLink" href="#timber/post/meta_object_field">#</a></h2><p>Filters field object data from Advanced Custom Fields.</p><p>This filter is used by the ACF Integration.</p><p><strong>see</strong> <a href="/docs/reference/timber-post/#field_object">Timber\Post::field_object()</a></p><p><strong>since</strong> 1.6.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$value</td><td><code>mixed</code></td><td>The value.</td></tr><tr><td>$post_id</td><td><code>int</code> or <code>null</code></td><td>The post ID.</td></tr><tr><td>$field_name</td><td><code>string</code></td><td>The ACF field name.</td></tr><tr><td>$post</td><td><code>\Post</code></td><td>The post object.</td></tr></tbody></table><h2 id="timber/post/authors" tabindex="-1">timber/post/authors <a class="directLink" href="#timber/post/authors">#</a></h2><p>Filters authors for a post.</p><p>This filter is used by the CoAuthorsPlus integration.</p><p><strong>see</strong> <a href="/docs/reference/timber-post/#authors">Timber\Post::authors()</a></p><p><strong>since</strong> 1.1.4</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$authors</td><td><code>array</code></td><td>An array of User objects. Default: User object for <code>post_author</code>.</td></tr><tr><td>$post</td><td><code>\Post</code></td><td>The post object.</td></tr></tbody></table><pre><code>add_filter( 'timber/post/authors', function( $author, $post ) {
+     foreach ($cauthors as $author) {
+       // do something with $author
+     }
+
+    return $authors;
+} );
+</code></pre><h2 id="timber/post/children_args" tabindex="-1">timber/post/children_args <a class="directLink" href="#timber/post/children_args">#</a></h2><p>Filters the arguments for the query used to get the children of a post.</p><p>This filter is used by the <code>Timber\Post::children()</code> method. It allows you to modify the arguments for the <code>get_children</code> function. This way you can change the query to get the children of a post.</p><p><strong>see</strong> <a href="/docs/reference/timber-post/#children">Timber\Post::children()</a></p><p><strong>since</strong> 2.1.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$arguments</td><td><code>array</code></td><td>An array of arguments for the <code>get_children</code> function.</td></tr><tr><td>$post</td><td><code>\Post</code></td><td>The post object.</td></tr></tbody></table><pre><code>add_filter( 'timber/post/children_args', function( $args, $post ) {
+
+    if ( $post-&gt;post_type === 'custom_post_type' ) {
+       $args['post_status'] = 'private';
+    }
+
+    return $args;
+} );
+</code></pre><h2 id="timber/post/content/show_password_form_for_protected" tabindex="-1">timber/post/content/show_password_form_for_protected <a class="directLink" href="#timber/post/content/show_password_form_for_protected">#</a></h2><p>Filters whether the password form should be shown for password protected posts.</p><p>This filter runs only when you call <code>{{ post.content }}</code> for a password protected post. When this filter returns <code>true</code>, a password form will be shown instead of the post content. If you want to modify the form itself, you can use the <code>timber/post/content/password_form</code> filter.</p><p><strong>since</strong> 1.1.4</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$show_pw</td><td><code>bool</code></td><td>Whether the password form should be shown. Default <code>false</code>.</td></tr></tbody></table><p><strong>PHP</strong></p><pre class="language-php"><code class="language-php"><span class="token comment">// Always show password form for password protected posts.</span><br><span class="token function">add_filter</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'timber/post/content/show_password_form_for_protected'</span><span class="token punctuation">,</span> <span class="token string single-quoted-string">'__return_true'</span> <span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h2 id="timber/post/content/password_form" tabindex="-1">timber/post/content/password_form <a class="directLink" href="#timber/post/content/password_form">#</a></h2><p>Filters the password form output.</p><p>As an alternative to this filter, you could also use WordPress’s <code>the_password_form</code> filter. The difference to this filter is, that you’ll also have the post object available as a second parameter, in case you need that.</p><p><strong>since</strong> 1.1.4</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$form</td><td><code>string</code></td><td>Form output. Default WordPress password form output generated by <code>get_the_password_form()</code>.</td></tr><tr><td>$post</td><td><code>\Post</code></td><td>The post object.</td></tr></tbody></table><p><strong>PHP</strong></p><pre class="language-php"><code class="language-php"><span class="token comment">// Modify the password form.</span><br><span class="token function">add_filter</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'timber/post/content/password_form'</span><span class="token punctuation">,</span> <span class="token keyword">function</span><span class="token punctuation">(</span> <span class="token variable">$form</span><span class="token punctuation">,</span> <span class="token variable">$post</span> <span class="token punctuation">)</span> <span class="token punctuation">{</span><br>    <span class="token keyword">return</span> <span class="token class-name static-context">Timber</span><span class="token operator">::</span><span class="token function">compile</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'assets/password-form.twig'</span><span class="token punctuation">,</span> <span class="token keyword">array</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'post'</span> <span class="token operator">=></span> <span class="token variable">$post</span> <span class="token punctuation">)</span> <span class="token punctuation">)</span><span class="token punctuation">;</span><br><span class="token punctuation">}</span><span class="token punctuation">,</span> <span class="token number">10</span><span class="token punctuation">,</span> <span class="token number">2</span> <span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h2 id="timber/post/content/remove_blocks" tabindex="-1">timber/post/content/remove_blocks <a class="directLink" href="#timber/post/content/remove_blocks">#</a></h2><p>Filters whether the content produced by block editor blocks should be removed or not from the content.</p><p>If truthy then block whose content does not belong in the excerpt, will be removed. This removal is done using WordPress Core <code>excerpt_remove_blocks</code> function.</p><p><strong>see</strong> excerpt_remove_blocks() The WordPress Core function that will handle the block removal from the excerpt.</p><p><strong>since</strong> 2.1.1</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$remove_blocks</td><td><code>bool</code></td><td>Whether blocks whose content should not be part of the excerpt should be removed or not from the excerpt.</td></tr></tbody></table><h2 id="timber/post/excerpt/defaults" tabindex="-1">timber/post/excerpt/defaults <a class="directLink" href="#timber/post/excerpt/defaults">#</a></h2><p>Filters the default options used for post excerpts.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$defaults</td><td><code>array</code></td><td>An array of default options. You can see which options you can use when you look at the <code>$options</code> parameter for <a href="https://timber.github.io/docs/v2/reference/timber-postexcerpt/#__construct">PostExcerpt::__construct()</a>.</td></tr></tbody></table><p><strong>PHP</strong></p><pre class="language-php"><code class="language-php"><span class="token function">add_filter</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'timber/post/excerpt/defaults'</span><span class="token punctuation">,</span> <span class="token keyword">function</span><span class="token punctuation">(</span> <span class="token variable">$defaults</span> <span class="token punctuation">)</span> <span class="token punctuation">{</span><br>    <span class="token comment">// Only add a read more link if the post content isn’t longer than the excerpt.</span><br>    <span class="token variable">$defaults</span><span class="token punctuation">[</span><span class="token string single-quoted-string">'always_add_read_more'</span><span class="token punctuation">]</span> <span class="token operator">=</span> <span class="token constant boolean">false</span><span class="token punctuation">;</span><br><br>    <span class="token comment">// Set a default character limit.</span><br>    <span class="token variable">$defaults</span><span class="token punctuation">[</span><span class="token string single-quoted-string">'words'</span><span class="token punctuation">]</span> <span class="token operator">=</span> <span class="token number">240</span><span class="token punctuation">;</span><br><br>    <span class="token keyword">return</span> <span class="token variable">$defaults</span><span class="token punctuation">;</span><br><span class="token punctuation">}</span> <span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h2 id="timber/post/excerpt/read_more_class" tabindex="-1">timber/post/excerpt/read_more_class <a class="directLink" href="#timber/post/excerpt/read_more_class">#</a></h2><p>Filters the CSS class used for excerpt links.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$class</td><td><code>string</code></td><td>The CSS class to use for the excerpt link. Default <code>read-more</code>.</td></tr></tbody></table><p><strong>PHP</strong></p><pre class="language-php"><code class="language-php"><span class="token comment">// Change the CSS class for excerpt links.</span><br><span class="token function">add_filter</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'timber/post/excerpt/read_more_class'</span><span class="token punctuation">,</span> <span class="token keyword">function</span><span class="token punctuation">(</span> <span class="token variable">$class</span> <span class="token punctuation">)</span> <span class="token punctuation">{</span><br>    <span class="token keyword">return</span> <span class="token string single-quoted-string">'read-more__link'</span><span class="token punctuation">;</span><br><span class="token punctuation">}</span> <span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h2 id="timber/post/preview/read_more_class" tabindex="-1">timber/post/preview/read_more_class <a class="directLink" href="#timber/post/preview/read_more_class">#</a></h2><p>Filters the CSS class used for excerpt links.</p><p><strong>DEPRECATED</strong> since 2.0.0</p><p><strong>since</strong> 1.0.4</p><h2 id="timber/post/excerpt/read_more_link" tabindex="-1">timber/post/excerpt/read_more_link <a class="directLink" href="#timber/post/excerpt/read_more_link">#</a></h2><p>Filters the link used for a read more text in an excerpt.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$link</td><td><code>string</code></td><td>The HTML link.</td></tr><tr><td>$post</td><td><code>\Post</code></td><td>Post instance.</td></tr><tr><td>$linktext</td><td><code>string</code></td><td>The link text.</td></tr><tr><td>$read_more_class</td><td><code>string</code></td><td>The CSS class name.</td></tr></tbody></table><h2 id="timber/post/get_preview/read_more_link" tabindex="-1">timber/post/get_preview/read_more_link <a class="directLink" href="#timber/post/get_preview/read_more_link">#</a></h2><p>Filters the link used for a read more text in an excerpt.</p><p><strong>DEPRECATED</strong> since 2.0.0</p><p><strong>since</strong> 1.1.3</p><h2 id="timber/site/update_option" tabindex="-1">timber/site/update_option <a class="directLink" href="#timber/site/update_option">#</a></h2><p>Filters a value before it is updated in the site options.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$value</td><td><code>mixed</code></td><td>The new value.</td></tr><tr><td>$key</td><td><code>string</code></td><td>The option key.</td></tr><tr><td>$site_id</td><td><code>int</code></td><td>The site ID.</td></tr><tr><td>$site</td><td><code>\Site</code></td><td>The site object.</td></tr></tbody></table><h2 id="timber_site_set_meta" tabindex="-1">timber_site_set_meta <a class="directLink" href="#timber_site_set_meta">#</a></h2><p>Filters a value before it is updated in the site options.</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/site/update_option</code></p><p><strong>since</strong> 0.20.0</p><h2 id="timber/term/link" tabindex="-1">timber/term/link <a class="directLink" href="#timber/term/link">#</a></h2><p>Filters the link to the term archive page.</p><p><strong>see</strong> <a href="/docs/reference/timber-term/#link">Timber\Term::link()</a></p><p><strong>since</strong> 0.21.9</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$link</td><td><code>string</code></td><td>The link.</td></tr><tr><td>$term</td><td><code>\Term</code></td><td>The term object.</td></tr></tbody></table><h2 id="timber_term_link" tabindex="-1">timber_term_link <a class="directLink" href="#timber_term_link">#</a></h2><p>Filters the link to the term archive page.</p><p><strong>DEPRECATED</strong> since 0.21.9, use <code>timber/term/link</code></p><h2 id="timber/term/path" tabindex="-1">timber/term/path <a class="directLink" href="#timber/term/path">#</a></h2><p>Filters the relative link (path) to a term archive page.</p><pre><code>add_filter( 'timber/term/path', function( $rel, $term ) {
+    if ( $term-&gt;slug === 'news' ) {
+       return '/category/modified-url';
+    }
+
+    return $rel;
+}, 10, 2 );
+</code></pre><p><strong>see</strong> <a href="/docs/reference/timber-term/#path">Timber\Term::path()</a></p><p><strong>since</strong> 0.21.9</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$rel</td><td><code>string</code></td><td>The relative link.</td></tr><tr><td>$term</td><td><code>\Term</code></td><td>The term object.</td></tr></tbody></table><h2 id="timber_term_path" tabindex="-1">timber_term_path <a class="directLink" href="#timber_term_path">#</a></h2><p>Filters the relative link (path) to a term archive page.</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/term/path</code></p><h2 id="timber_term_set_meta" tabindex="-1">timber_term_set_meta <a class="directLink" href="#timber_term_set_meta">#</a></h2><p>Filters term meta value that is going to be updated.</p><p><strong>DEPRECATED</strong> since 2.0.0 with no replacement</p><h2 id="timber/term/meta/set" tabindex="-1">timber/term/meta/set <a class="directLink" href="#timber/term/meta/set">#</a></h2><p>Filters term meta value that is going to be updated.</p><p><strong>DEPRECATED</strong> since 2.0.0, with no replacement</p><p>This filter is used by the ACF Integration.</p><h2 id="timber/trim_words/allowed_tags" tabindex="-1">timber/trim_words/allowed_tags <a class="directLink" href="#timber/trim_words/allowed_tags">#</a></h2><p>Filters allowed tags for <code>trim_words()</code> helper.</p><p>The <code>trim_words()</code> helper strips all HTML tags from a text it trims, except for a list of allowed tags. Instead of passing the allowed tags every time you use <code>trim_words()</code> (or <code>{{ text|truncate }}</code> in Twig), you can use this filter to set the allowed tags.</p><p><strong>see</strong> <a href="/docs/reference/timber-texthelper/#trim_words">Timber\TextHelper::trim_words()</a></p><p><strong>since</strong> 0.21.9</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$allowed_tags</td><td><code>string</code></td><td>Allowed tags, separated by one whitespace. Default <code>p a span b i br blockquote</code>.</td></tr></tbody></table><h2 id="timber/integrations" tabindex="-1">timber/integrations <a class="directLink" href="#timber/integrations">#</a></h2><p>Filters the integrations that should be initialized by Timber.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$integrations</td><td><code>\IntegrationInterface[]</code></td><td>An array of PHP class names. Default: array of integrations that Timber initializes by default.</td></tr></tbody></table><h2 id="timber/context" tabindex="-1">timber/context <a class="directLink" href="#timber/context">#</a></h2><p>Filters the global Timber context.</p><p>By using this filter, you can add custom data to the global Timber context, which means that this data will be available on every page that is initialized with <code>Timber::context()</code>.</p><p>Be aware that data will be cached as soon as you call <code>Timber::context()</code> for the first time. That’s why you should add this filter before you call <code>Timber::context()</code>.</p><p><strong>see</strong> <a href="/docs/reference/timber-timber/#context">Timber\Timber::context()</a></p><p><strong>since</strong> 0.21.7</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$context</td><td><code>array</code></td><td>The global context.</td></tr></tbody></table><p><strong>PHP</strong></p><pre class="language-php"><code class="language-php"><span class="token function">add_filter</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'timber/context'</span><span class="token punctuation">,</span> <span class="token keyword">function</span><span class="token punctuation">(</span> <span class="token variable">$context</span> <span class="token punctuation">)</span> <span class="token punctuation">{</span><br>    <span class="token comment">// Example: A custom value</span><br>    <span class="token variable">$context</span><span class="token punctuation">[</span><span class="token string single-quoted-string">'custom_site_value'</span><span class="token punctuation">]</span> <span class="token operator">=</span> <span class="token string single-quoted-string">'Hooray!'</span><span class="token punctuation">;</span><br><br>    <span class="token comment">// Example: Add a menu to the global context.</span><br>    <span class="token variable">$context</span><span class="token punctuation">[</span><span class="token string single-quoted-string">'menu'</span><span class="token punctuation">]</span> <span class="token operator">=</span> <span class="token keyword">new</span> <span class="token class-name class-name-fully-qualified"><span class="token punctuation">\</span>Timber<span class="token punctuation">\</span>Menu</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'primary-menu'</span> <span class="token punctuation">)</span><span class="token punctuation">;</span><br><br>    <span class="token comment">// Example: Add all ACF options to global context.</span><br>    <span class="token variable">$context</span><span class="token punctuation">[</span><span class="token string single-quoted-string">'options'</span><span class="token punctuation">]</span> <span class="token operator">=</span> <span class="token function">get_fields</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'options'</span> <span class="token punctuation">)</span><span class="token punctuation">;</span><br><br>    <span class="token keyword">return</span> <span class="token variable">$context</span><span class="token punctuation">;</span><br><span class="token punctuation">}</span> <span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><p><strong>Twig</strong></p><pre class="language-twig"><code class="language-twig"><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>h1</span><span class="token punctuation">></span></span><span class="token twig language-twig"><span class="token delimiter punctuation">{{</span> custom_site_value<span class="token operator">|</span>e <span class="token delimiter punctuation">}}</span></span><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>h1</span><span class="token punctuation">></span></span><br><br><span class="token twig language-twig"><span class="token delimiter punctuation">{%</span> <span class="token tag-name keyword">for</span> item <span class="token operator">in</span> menu<span class="token punctuation">.</span>items <span class="token delimiter punctuation">%}</span></span><br>    <span class="token twig language-twig"><span class="token comment">{# Display menu item #}</span></span><br><span class="token twig language-twig"><span class="token delimiter punctuation">{%</span> <span class="token tag-name keyword">endfor</span> <span class="token delimiter punctuation">%}</span></span><br><br><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;</span>footer</span><span class="token punctuation">></span></span><br>    <span class="token twig language-twig"><span class="token delimiter punctuation">{%</span> <span class="token tag-name keyword">if</span> options<span class="token punctuation">.</span>footer_text <span class="token operator">is</span> <span class="token operator">not</span> empty <span class="token delimiter punctuation">%}</span></span><br>        <span class="token twig language-twig"><span class="token delimiter punctuation">{{</span> options<span class="token punctuation">.</span>footer_text<span class="token operator">|</span>e <span class="token delimiter punctuation">}}</span></span><br>    <span class="token twig language-twig"><span class="token delimiter punctuation">{%</span> <span class="token tag-name keyword">endif</span> <span class="token delimiter punctuation">%}</span></span><br><span class="token tag"><span class="token tag"><span class="token punctuation">&lt;/</span>footer</span><span class="token punctuation">></span></span></code></pre><h2 id="timber_context" tabindex="-1">timber_context <a class="directLink" href="#timber_context">#</a></h2><p>Filters the global Timber context.</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/context</code></p><h2 id="timber/render/file" tabindex="-1">timber/render/file <a class="directLink" href="#timber/render/file">#</a></h2><p>Filters the Twig template that should be rendered.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$file</td><td><code>string</code></td><td>The chosen Twig template name to render.</td></tr></tbody></table><h2 id="timber_render_file" tabindex="-1">timber_render_file <a class="directLink" href="#timber_render_file">#</a></h2><p>Filters the Twig file that should be rendered.</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/render/file</code></p><h2 id="timber/compile/file" tabindex="-1">timber/compile/file <a class="directLink" href="#timber/compile/file">#</a></h2><p>Filters the Twig template that should be compiled.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$file</td><td><code>string</code></td><td>The chosen Twig template name to compile.</td></tr></tbody></table><h2 id="timber_compile_file" tabindex="-1">timber_compile_file <a class="directLink" href="#timber_compile_file">#</a></h2><p>Filters the Twig template that should be compiled.</p><p><strong>DEPRECATED</strong> since 2.0.0</p><h2 id="timber/render/data" tabindex="-1">timber/render/data <a class="directLink" href="#timber/render/data">#</a></h2><p>Filters the data that should be passed for rendering a Twig template.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$data</td><td><code>array</code></td><td>The data that is used to render the Twig template.</td></tr><tr><td>$file</td><td><code>string</code></td><td>The name of the Twig template to render.</td></tr></tbody></table><h2 id="timber_render_data" tabindex="-1">timber_render_data <a class="directLink" href="#timber_render_data">#</a></h2><p>Filters the data that should be passed for rendering a Twig template.</p><p><strong>DEPRECATED</strong> since 2.0.0</p><h2 id="timber/compile/data" tabindex="-1">timber/compile/data <a class="directLink" href="#timber/compile/data">#</a></h2><p>Filters the data that should be passed for compiling a Twig template.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$data</td><td><code>array</code></td><td>The data that is used to compile the Twig template.</td></tr><tr><td>$file</td><td><code>string</code></td><td>The name of the Twig template to compile.</td></tr></tbody></table><h2 id="timber_compile_data" tabindex="-1">timber_compile_data <a class="directLink" href="#timber_compile_data">#</a></h2><p>Filters the data that should be passed for compiling a Twig template.</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/compile/data</code></p><h2 id="timber/compile/result" tabindex="-1">timber/compile/result <a class="directLink" href="#timber/compile/result">#</a></h2><p>Filters the compiled result before it is returned in <code>Timber::compile()</code>.</p><p>It adds the possibility to filter the output ready for render.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$output</td><td><code>string</code> or <code>bool</code></td><td>the compiled output.</td></tr></tbody></table><h2 id="timber_compile_result" tabindex="-1">timber_compile_result <a class="directLink" href="#timber_compile_result">#</a></h2><p>Filters the compiled result before it is returned.</p><p><strong>DEPRECATED</strong> since 2.0.0 use timber/compile/result</p><p><strong>see</strong> <a href="/docs/reference/timber-timber/#fetch">Timber\Timber::fetch()</a></p><p><strong>since</strong> 0.16.7</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$output</td><td><code>string</code></td><td>The compiled output.</td></tr></tbody></table><h2 id="timber/twig/functions" tabindex="-1">timber/twig/functions <a class="directLink" href="#timber/twig/functions">#</a></h2><p>Filters the functions that are added to Twig.</p><p>The <code>$functions</code> array is an associative array with the filter name as a key and an arguments array as the value. In the arguments array, you pass the function to call with a <code>callable</code> entry.</p><p>This is an alternative filter that you can use instead of adding your function in the <code>timber/twig</code> filter.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$functions</td><td><code>array</code></td><td></td></tr></tbody></table><p><strong>PHP</strong></p><pre class="language-php"><code class="language-php"><span class="token function">add_filter</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'timber/twig/functions'</span><span class="token punctuation">,</span> <span class="token keyword">function</span><span class="token punctuation">(</span> <span class="token variable">$functions</span> <span class="token punctuation">)</span> <span class="token punctuation">{</span><br>    <span class="token comment">// Add your own function.</span><br>    <span class="token variable">$functions</span><span class="token punctuation">[</span><span class="token string single-quoted-string">'url_to_domain'</span><span class="token punctuation">]</span> <span class="token operator">=</span> <span class="token punctuation">[</span><br>        <span class="token string single-quoted-string">'callable'</span> <span class="token operator">=></span> <span class="token string single-quoted-string">'url_to_domain'</span><span class="token punctuation">,</span><br>    <span class="token punctuation">]</span><span class="token punctuation">;</span><br><br>    <span class="token comment">// Replace a function.</span><br>    <span class="token variable">$functions</span><span class="token punctuation">[</span><span class="token string single-quoted-string">'get_image'</span><span class="token punctuation">]</span> <span class="token operator">=</span> <span class="token punctuation">[</span><br>        <span class="token string single-quoted-string">'callable'</span> <span class="token operator">=></span> <span class="token string single-quoted-string">'custom_image_get'</span><span class="token punctuation">,</span><br>    <span class="token punctuation">]</span><span class="token punctuation">;</span><br><br>    <span class="token comment">// Remove a function.</span><br>    <span class="token keyword">unset</span><span class="token punctuation">(</span> <span class="token variable">$functions</span><span class="token punctuation">[</span><span class="token string single-quoted-string">'bloginfo'</span><span class="token punctuation">]</span> <span class="token punctuation">)</span><span class="token punctuation">;</span><br><br>    <span class="token keyword">return</span> <span class="token variable">$functions</span><span class="token punctuation">;</span><br><span class="token punctuation">}</span> <span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h2 id="timber/twig/filters" tabindex="-1">timber/twig/filters <a class="directLink" href="#timber/twig/filters">#</a></h2><p>Filters the filters that are added to Twig.</p><p>The <code>$filters</code> array is an associative array with the filter name as a key and an arguments array as the value. In the arguments array, you pass the function to call with a <code>callable</code> entry.</p><p>This is an alternative filter that you can use instead of adding your filter in the <code>timber/twig</code> filter.</p><p><strong>since</strong> 2.0.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$filters</td><td><code>array</code></td><td></td></tr></tbody></table><p><strong>PHP</strong></p><pre class="language-php"><code class="language-php"><span class="token function">add_filter</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'timber/twig/default_filters'</span><span class="token punctuation">,</span> <span class="token keyword">function</span><span class="token punctuation">(</span> <span class="token variable">$filters</span> <span class="token punctuation">)</span> <span class="token punctuation">{</span><br>    <span class="token comment">// Add your own filter.</span><br>    <span class="token variable">$filters</span><span class="token punctuation">[</span><span class="token string single-quoted-string">'price'</span><span class="token punctuation">]</span> <span class="token operator">=</span> <span class="token punctuation">[</span><br>        <span class="token string single-quoted-string">'callable'</span> <span class="token operator">=></span> <span class="token string single-quoted-string">'format_price'</span><span class="token punctuation">,</span><br>    <span class="token punctuation">]</span><span class="token punctuation">;</span><br><br>    <span class="token comment">// Replace a filter.</span><br>    <span class="token variable">$filters</span><span class="token punctuation">[</span><span class="token string single-quoted-string">'list'</span><span class="token punctuation">]</span> <span class="token operator">=</span> <span class="token punctuation">[</span><br>        <span class="token string single-quoted-string">'callable'</span> <span class="token operator">=></span> <span class="token string single-quoted-string">'custom_list_filter'</span><span class="token punctuation">,</span><br>    <span class="token punctuation">]</span><span class="token punctuation">;</span><br><br>    <span class="token comment">// Remove a filter.</span><br>    <span class="token keyword">unset</span><span class="token punctuation">(</span> <span class="token variable">$filters</span><span class="token punctuation">[</span><span class="token string single-quoted-string">'list'</span><span class="token punctuation">]</span> <span class="token punctuation">)</span><span class="token punctuation">;</span><br><br>    <span class="token keyword">return</span> <span class="token variable">$filters</span><span class="token punctuation">;</span><br><span class="token punctuation">}</span> <span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h2 id="timber/twig/escapers" tabindex="-1">timber/twig/escapers <a class="directLink" href="#timber/twig/escapers">#</a></h2><p>Filters the escaping filters that are added to Twig.</p><p>The <code>$escaper_filters</code> array is an associative array with the filter name as a key and an arguments array as the value. In the arguments array, you pass the function to call with a <code>callable</code> entry.</p><p><strong>since</strong> 2.1.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$escaper_filters</td><td><code>array</code></td><td></td></tr></tbody></table><p><strong>PHP</strong></p><pre class="language-php"><code class="language-php"><span class="token function">add_filter</span><span class="token punctuation">(</span> <span class="token string single-quoted-string">'timber/twig/escapers'</span><span class="token punctuation">,</span> <span class="token keyword">function</span><span class="token punctuation">(</span> <span class="token variable">$escaper_filters</span> <span class="token punctuation">)</span> <span class="token punctuation">{</span><br>    <span class="token comment">// Add your own filter.</span><br>    <span class="token variable">$filters</span><span class="token punctuation">[</span><span class="token string single-quoted-string">'esc_xml'</span><span class="token punctuation">]</span> <span class="token operator">=</span> <span class="token punctuation">[</span><br>        <span class="token string single-quoted-string">'callable'</span> <span class="token operator">=></span> <span class="token string single-quoted-string">'esc_xml'</span><span class="token punctuation">,</span><br>         <span class="token string single-quoted-string">'options'</span> <span class="token operator">=></span> <span class="token punctuation">[</span><br>            <span class="token string single-quoted-string">'is_safe'</span> <span class="token operator">=></span> <span class="token punctuation">[</span><span class="token string single-quoted-string">'html'</span><span class="token punctuation">]</span><span class="token punctuation">,</span><br>         <span class="token punctuation">]</span><span class="token punctuation">,</span><br>    <span class="token punctuation">]</span><span class="token punctuation">;</span><br><br>    <span class="token comment">// Remove a filter.</span><br>    <span class="token keyword">unset</span><span class="token punctuation">(</span> <span class="token variable">$filters</span><span class="token punctuation">[</span><span class="token string single-quoted-string">'esc_js'</span><span class="token punctuation">]</span> <span class="token punctuation">)</span><span class="token punctuation">;</span><br><br>    <span class="token keyword">return</span> <span class="token variable">$filters</span><span class="token punctuation">;</span><br><span class="token punctuation">}</span> <span class="token punctuation">)</span><span class="token punctuation">;</span></code></pre><h2 id="timber/url_helper/url_to_file_system/path" tabindex="-1">timber/url_helper/url_to_file_system/path <a class="directLink" href="#timber/url_helper/url_to_file_system/path">#</a></h2><p>Filters the path of a parsed URL.</p><p>You can use this filter to alter the returned file system path. This filter is used by the WPML integration.</p><p><strong>see</strong> <a href="/docs/reference/timber-urlhelper/#url_to_file_system">Timber\URLHelper::url_to_file_system()</a></p><p><strong>since</strong> 1.3.2</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$path</td><td><code>string</code></td><td>The current translated path</td></tr></tbody></table><h2 id="timber/urlhelper/url_to_file_system/path" tabindex="-1">timber/URLHelper/url_to_file_system/path <a class="directLink" href="#timber/urlhelper/url_to_file_system/path">#</a></h2><p>Filters the path of a parsed URL.</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/url_helper/url_to_file_system/path</code></p><h2 id="timber/url_helper/file_system_to_url" tabindex="-1">timber/url_helper/file_system_to_url <a class="directLink" href="#timber/url_helper/file_system_to_url">#</a></h2><p>Filters the URL in URLHelper::file_system_to_url</p><p>You can use this filter to alter the returned URL. This filter is used by the WPML integration.</p><p><strong>see</strong> <a href="/docs/reference/timber-urlhelper/#file_system_to_url">Timber\URLHelper::file_system_to_url()</a></p><p><strong>since</strong> 1.3.2</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$url</td><td><code>string</code></td><td>The current translated url</td></tr></tbody></table><h2 id="timber/urlhelper/file_system_to_url" tabindex="-1">timber/URLHelper/file_system_to_url <a class="directLink" href="#timber/urlhelper/file_system_to_url">#</a></h2><p>Filters the URL in URLHelper::file_system_to_url</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/url_helper/file_system_to_url</code></p><p>You can use this filter to alter the returned URL. This filter is used by the WPML integration.</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$url</td><td><code>string</code></td><td>The current url</td></tr></tbody></table><h2 id="timber/url_helper/get_content_subdir/home_url" tabindex="-1">timber/url_helper/get_content_subdir/home_url <a class="directLink" href="#timber/url_helper/get_content_subdir/home_url">#</a></h2><p>Filters the home URL that is used to get the path relative to the content directory.</p><p><strong>since</strong> 1.3.2</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$home_url</td><td><code>string</code></td><td>The URL to use as the base for getting the content subdirectory. Default value of <code>home_url()</code>.</td></tr></tbody></table><h2 id="timber/urlhelper/get_content_subdir/home_url" tabindex="-1">timber/URLHelper/get_content_subdir/home_url <a class="directLink" href="#timber/urlhelper/get_content_subdir/home_url">#</a></h2><p>Filters the home URL that is used to get the path relative to the content directory.</p><p><strong>DEPRECATED</strong> since 2.0.0, use <code>timber/url_helper/get_content_subdir/home_url</code></p><h2 id="timber/url/schemes-whitelist" tabindex="-1">timber/url/schemes-whitelist <a class="directLink" href="#timber/url/schemes-whitelist">#</a></h2><p>Filters the schemes that are excluded for double slash removal.</p><p>If an url start with one of the schemes in the whitelist, that scheme will be excluded from the double slash removal.</p><p><strong>since</strong> 1.16.0</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$schemes_whitelist</td><td><code>array</code></td><td>the schemes that are excluded for double slash removal.</td></tr></tbody></table><h2 id="timber/user/name" tabindex="-1">timber/user/name <a class="directLink" href="#timber/user/name">#</a></h2><p>Filters the name of a user.</p><p><strong>since</strong> 1.1.4</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$name</td><td><code>string</code></td><td>The name of the user. Default <code>display_name</code>.</td></tr><tr><td>$user</td><td><code>\User</code></td><td>The user object.</td></tr></tbody></table></div></article></main></div></div><script src="https://cdn.jsdelivr.net/npm/@docsearch/js@3"></script><script>docsearch({
     appId: '7REN4GR6X4',
     apiKey: '9acbf22ef9a9b117a0f9ba50bd2f4280',
     /**
diff --git a/docs/v2/reference/timber-texthelper/index.html b/docs/v2/reference/timber-texthelper/index.html
index bd8775cc..df5f7be4 100644
--- a/docs/v2/reference/timber-texthelper/index.html
+++ b/docs/v2/reference/timber-texthelper/index.html
@@ -2,7 +2,7 @@
 	  function gtag(){dataLayer.push(arguments);}
 	  gtag('js', new Date());
 
-	  gtag('config', 'UA-126807198-1');</script><title>Timber&#92;​TextHelper – Timber v2 – Timber Documentation</title><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta http-equiv="x-ua-compatible" content="ie=edge"><meta name="docsearch:version" content="v2"><link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@docsearch/css@3"><link rel="stylesheet" href="/docs/build/css/styles.css?id=c9d85857d742479204d190fd66fabaf1"><link rel="stylesheet" href="/docs/build/css/mobile.css?id=eb03f5e9c806ca82b2fc8d728401461a" media="screen and (max-width: 979px)"><script src="/docs/build/js/app.js?id=4594e1490acc2ce9d471fb2243cbcfce" defer="defer"></script><link rel="icon" href="/docs/build/favicons/favicon.ico" type="image/x-icon"><link rel="apple-touch-icon-precomposed" sizes="57x57" href="/docs/build/favicons/apple-touch-icon-57x57.png"><link rel="apple-touch-icon-precomposed" sizes="114x114" href="/docs/build/favicons/apple-touch-icon-114x114.png"><link rel="apple-touch-icon-precomposed" sizes="72x72" href="/docs/build/favicons/apple-touch-icon-72x72.png"><link rel="apple-touch-icon-precomposed" sizes="144x144" href="/docs/build/favicons/apple-touch-icon-144x144.png"><link rel="apple-touch-icon-precomposed" sizes="60x60" href="/docs/build/favicons/apple-touch-icon-60x60.png"><link rel="apple-touch-icon-precomposed" sizes="120x120" href="/docs/build/favicons/apple-touch-icon-120x120.png"><link rel="apple-touch-icon-precomposed" sizes="76x76" href="favicons/apple-touch-icon-76x76.png"><link rel="apple-touch-icon-precomposed" sizes="152x152" href="favicons/apple-touch-icon-152x152.png"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-196x196.png" sizes="196x196"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-96x96.png" sizes="96x96"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-32x32.png" sizes="32x32"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-16x16.png" sizes="16x16"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-128.png" sizes="128x128"><meta name="application-name" content="Timber Documentation"><meta name="msapplication-TileColor" content="#FFFFFF"><meta name="msapplication-TileImage" content="/docs/build/favicons/mstile-144x144.png"><meta name="msapplication-square70x70logo" content="/docs/build/favicons/mstile-70x70.png"><meta name="msapplication-square150x150logo" content="/docs/build/favicons/mstile-150x150.png"><meta name="msapplication-wide310x150logo" content="/docs/build/favicons/mstile-310x150.png"><meta name="msapplication-square310x310logo" content="/docs/build/favicons/mstile-310x310.png"><meta name="twitter:card" content="summary_large_image"><meta name="twitter:site" content="@TimberWP"><meta name="twitter:title" content="Timber for WordPress Documentation"><meta name="twitter:description" content="Create WordPress themes with beautiful OOP code and the Twig Template Engine"><meta name="twitter:image" content="https://repository-images.githubusercontent.com/7413451/06c62480-b95c-11ea-8b35-b5dd97d070f1"></head><body><header class="header"><div class="logoContainer"><a href="/docs/"><img src="/docs/build/img/timber-logo.svg" alt="Timber Logo" style="width: 105px; height: 30px; border: 0" role="img"></a></div><div class="search"><div id="docsearch"></div></div><nav class="navTop" id="nav-top"><ul><li><a href="https://upstatement.com/timber/" target="_blank" rel="noreferrer noopener">About Timber</a></li><li><a href="https://twig.symfony.com/doc/" target="_blank" rel="noreferrer noopener">Twig Docs</a></li><li><a href="https://opencollective.com/timber" target="_blank" rel="noreferrer noopener">Sponsor us</a></li><li><a href="https://github.com/timber/timber" target="_blank" rel="noreferrer noopener"><img src="/docs/build/img/github.png" alt="Star on Github" style="width: 29px; height: 29px; border: 0"></a></li></ul></nav><button class="navMobileToggle js-menu-open" type="button" id="nav-mobile-toggle"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 34"><path d="M45.6,19.43H2.4a2.43,2.43,0,0,1,0-4.86H45.6a2.43,2.43,0,0,1,0,4.86Z"/><path d="M45.6,4.86H2.4A2.41,2.41,0,0,1,0,2.43,2.41,2.41,0,0,1,2.4,0H45.6A2.41,2.41,0,0,1,48,2.43,2.41,2.41,0,0,1,45.6,4.86Z"/><path d="M45.6,34H2.4a2.43,2.43,0,0,1,0-4.86H45.6a2.43,2.43,0,0,1,0,4.86Z"/></svg> <span class="sr-only">Menu</span></button></header><div class="wrapper"><aside class="sidebar slideup-menu" id="sidebar" data-turbolinks-keep-scroll-position><button class="navClose js-menu-close" type="button"><div class="navClose-icon" aria-hidden="true"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48"><path d="M3.43,48A3.43,3.43,0,0,1,1,42.15L42.15,1A3.43,3.43,0,1,1,47,5.85L5.85,47A3.4,3.4,0,0,1,3.43,48Z"/><path d="M44.57,48a3.4,3.4,0,0,1-2.42-1L1,5.85A3.43,3.43,0,0,1,5.85,1L47,42.15A3.43,3.43,0,0,1,44.57,48Z"/></svg></div><span class="sr-only">Close Menu</span></button><nav class="navVersions"><ul><li><a href="/docs/v2/" class="is-current">v2.x</a></li><li><a href="/docs/v1/">v1.x</a></li></ul></nav><nav id="nav-main" class="navMain"><ul class="navMain-sections"><li class="navMain-section"><h3 class="navMain-title">Installation</h3><ul class="navMain-items"><li class="navMain-item" data-order="10"><a class="navMain-link" href="/docs/v2/installation/installation/">Installation</a></li><li class="navMain-item" data-order="30"><a class="navMain-link" href="/docs/v2/installation/manage-timber-with-composer/">Managing Timber with Composer</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Getting Started</h3><ul class="navMain-items"><li class="navMain-item" data-order="100"><a class="navMain-link" href="/docs/v2/getting-started/introduction/">Introduction</a></li><li class="navMain-item" data-order="200"><a class="navMain-link" href="/docs/v2/getting-started/template-inheritance-and-includes/">Template inheritance and includes</a></li><li class="navMain-item" data-order="300"><a class="navMain-link" href="/docs/v2/getting-started/a-single-post/">A single post</a></li><li class="navMain-item" data-order="400"><a class="navMain-link" href="/docs/v2/getting-started/a-post-archive/">A post archive</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Guides</h3><ul class="navMain-items"><li class="navMain-item" data-order="50"><a class="navMain-link" href="/docs/v2/guides/context/">Context</a></li><li class="navMain-item" data-order="75"><a class="navMain-link" href="/docs/v2/guides/template-locations/">Template Locations</a></li><li class="navMain-item" data-order="110"><a class="navMain-link" href="/docs/v2/guides/posts/">Posts</a></li><li class="navMain-item" data-order="120"><a class="navMain-link" href="/docs/v2/guides/terms/">Terms</a></li><li class="navMain-item" data-order="130"><a class="navMain-link" href="/docs/v2/guides/users/">Users</a></li><li class="navMain-item" data-order="140"><a class="navMain-link" href="/docs/v2/guides/comments/">Comments</a></li><li class="navMain-item" data-order="150"><a class="navMain-link" href="/docs/v2/guides/menus/">Menus</a></li><li class="navMain-item" data-order="160"><a class="navMain-link" href="/docs/v2/guides/widgets/">Widgets</a></li><li class="navMain-item" data-order="170"><a class="navMain-link" href="/docs/v2/guides/shortcodes/">Shortcodes</a></li><li class="navMain-item" data-order="200"><a class="navMain-link" href="/docs/v2/guides/twig/">Twig</a></li><li class="navMain-item" data-order="220"><a class="navMain-link" href="/docs/v2/guides/twig-filters/">Twig filters</a></li><li class="navMain-item" data-order="300"><a class="navMain-link" href="/docs/v2/guides/cookbook-text/">Text Cookbook</a></li><li class="navMain-item" data-order="400"><a class="navMain-link" href="/docs/v2/guides/escaping/">Escaping</a></li><li class="navMain-item" data-order="500"><a class="navMain-link" href="/docs/v2/guides/custom-page-templates/">Custom Page Templates</a></li><li class="navMain-item" data-order="600"><a class="navMain-link" href="/docs/v2/guides/custom-fields/">Custom Fields</a></li><li class="navMain-item" data-order="800"><a class="navMain-link" href="/docs/v2/guides/functions/">Functions</a></li><li class="navMain-item" data-order="1000"><a class="navMain-link" href="/docs/v2/guides/cookbook-images/">Image Cookbook</a></li><li class="navMain-item" data-order="1100"><a class="navMain-link" href="/docs/v2/guides/pagination/">Pagination</a></li><li class="navMain-item" data-order="1200"><a class="navMain-link" href="/docs/v2/guides/sidebars/">Sidebars</a></li><li class="navMain-item" data-order="1300"><a class="navMain-link" href="/docs/v2/guides/performance/">Performance/Caching</a></li><li class="navMain-item" data-order="1350"><a class="navMain-link" href="/docs/v2/guides/date-time/">Date/Time in Timber</a></li><li class="navMain-item" data-order="1400"><a class="navMain-link" href="/docs/v2/guides/internationalization/">Internationalization</a></li><li class="navMain-item" data-order="1500"><a class="navMain-link" href="/docs/v2/guides/cheatsheet/">Cheatsheet</a></li><li class="navMain-item" data-order="1550"><a class="navMain-link" href="/docs/v2/guides/gutenberg/">Block Editor (Gutenberg)</a></li><li class="navMain-item" data-order="1600"><a class="navMain-link" href="/docs/v2/guides/extending-timber/">Extending Timber</a></li><li class="navMain-item" data-order="1650"><a class="navMain-link" href="/docs/v2/guides/extending-twig/">Extending Twig</a></li><li class="navMain-item" data-order="1660"><a class="navMain-link" href="/docs/v2/guides/class-maps/">Class Maps</a></li><li class="navMain-item" data-order="1670"><a class="navMain-link" href="/docs/v2/guides/wp-cli/">WP-CLI</a></li><li class="navMain-item" data-order="1700"><a class="navMain-link" href="/docs/v2/guides/hosts-servers/">Hosts &amp; Servers</a></li><li class="navMain-item" data-order="1800"><a class="navMain-link" href="/docs/v2/guides/debugging/">Debugging</a></li><li class="navMain-item" data-order="1900"><a class="navMain-link" href="/docs/v2/guides/testing/">Automated Testing</a></li><li class="navMain-item" data-order="2000"><a class="navMain-link" href="/docs/v2/guides/routing/">Routing</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/guides/custom-integrations/">Custom Integrations</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/guides/woocommerce/">WooCommerce</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title navMain-sectionTitle">Reference</h3><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-archives/">Archives</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-attachment/">Attachment</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-cache-cleaner/">Cleaner</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-comment/">Comment</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-datetimehelper/">DateTimeHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-externalimage/">ExternalImage</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-helper/">Helper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-image/">Image</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-imagedimensions/">ImageDimensions</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-imagehelper/">ImageHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-menu/">Menu</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-menuitem/">MenuItem</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-pagesmenu/">PagesMenu</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-pagination/">Pagination</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-pathhelper/">PathHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-post/">Post</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-postarrayobject/">PostArrayObject</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-postexcerpt/">PostExcerpt</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-postquery/">PostQuery</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-site/">Site</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-term/">Term</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-texthelper/" aria-current>TextHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-theme/">Theme</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-timber/">Timber</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-urlhelper/">URLHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-user/">User</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Hooks</h3><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/hooks/actions/">Action Hooks</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/hooks/filters/">Filter Hooks</a></li></ul></li><li class="navMain-section"><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/integrations/advanced-custom-fields/">Advanced Custom Fields</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Upgrade Guides</h3><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/upgrade-guides/1.0/">Upgrade to 1.0</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/upgrade-guides/2.0/">Upgrade to 2.0</a></li></ul></li><li class="navMain-section"><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/contributing/">Contributing to Timber</a></li></ul></li></ul></nav></aside><div class="main-container"><div class="version-note"><p>You are reading the documentation for <strong>Timber v2.x</strong>. Switch to the documentation for Timber <a href="/docs/v1/">v1.x</a>.</p></div><main><article><h1>Timber&#92;​TextHelper</h1><aside><h2 class="heading-small">On this page</h2><nav class="toc"><ol><li><a href="#overview">Overview</a><ol><li><a href="#methods">Methods</a></li></ol></li><li><a href="#class-methods">Class Methods</a><ol><li><a href="#trim_characters">trim_characters()</a></li><li><a href="#trim_words">trim_words()</a></li><li><a href="#remove_tags">remove_tags()</a></li></ol></li></ol></nav></aside><div class="content"><p>Class provides different text-related functions commonly used in WordPress development</p><h2 id="overview" tabindex="-1">Overview <a class="directLink" href="#overview">#</a></h2><h3 id="methods" tabindex="-1">Methods <a class="directLink" href="#methods">#</a></h3><div class="table-methods"><table><thead><tr><th>Name</th><th>Return Type</th><th>Summary/Returns</th></tr></thead><tbody><tr><td><span class="method-name"><a href="#remove_tags">remove_tags()</a></span></td><td><span class="method-type"><code>null</code> or <code>string</code> or <code>string[]</code></span></td><td><span class="method-description"></span></td></tr><tr><td><span class="method-name"><a href="#trim_characters">trim_characters()</a></span></td><td><span class="method-type"><code>string</code></span></td><td><span class="method-description">Trims text to a certain number of characters.<br><br><span class="method-return"><span class="method-return-label">Returns:</span> trimmed text.</span></span></td></tr><tr><td><span class="method-name"><a href="#trim_words">trim_words()</a></span></td><td><span class="method-type"><code>string</code></span></td><td><span class="method-description"></span></td></tr></tbody></table></div><h2 id="class-methods" tabindex="-1">Class Methods <a class="directLink" href="#class-methods">#</a></h2><h3 id="trim_characters" tabindex="-1">trim_characters() <a class="directLink" href="#trim_characters">#</a></h3><p>Trims text to a certain number of characters.</p><p>This function can be useful for excerpt of the post As opposed to wp_trim_words trims characters that makes text to take the same amount of space in each post for example</p><p><strong>since</strong> 1.2.0</p><p><code>trim_characters( string $text, int $num_chars = 60, string $more = '&amp;hellip;' )</code></p><p><strong>Returns:</strong> <code>string</code> trimmed text.</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$text</td><td><code>string</code></td><td>Text to trim.</td></tr><tr><td>$num_chars</td><td><code>int</code></td><td>Number of characters. Default is 60.</td></tr><tr><td>$more</td><td><code>string</code></td><td>What to append if $text needs to be trimmed. Defaults to '…'.</td></tr></tbody></table><hr><h3 id="trim_words" tabindex="-1">trim_words() <a class="directLink" href="#trim_words">#</a></h3><p><code>trim_words( string $text, int $num_words = 55, string|null|false $more = null, string $allowed_tags = 'p a span b i br blockquote' )</code></p><p><strong>Returns:</strong> <code>string</code></p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$text</td><td><code>string</code></td><td></td></tr><tr><td>$num_words</td><td><code>int</code></td><td></td></tr><tr><td>$more</td><td><code>string</code> or <code>null</code> or <code>false</code></td><td>text to appear in &quot;Read more...&quot;. Null to use default, false to hide</td></tr><tr><td>$allowed_tags</td><td><code>string</code></td><td></td></tr></tbody></table><hr><h3 id="remove_tags" tabindex="-1">remove_tags() <a class="directLink" href="#remove_tags">#</a></h3><p><code>remove_tags( mixed $string, array $tags = [] )</code></p><p><strong>Returns:</strong> <code>null|string|string[]</code></p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$string</td><td></td><td></td></tr><tr><td>$tags</td><td><code>array</code></td><td></td></tr></tbody></table><hr></div></article></main></div></div><script src="https://cdn.jsdelivr.net/npm/@docsearch/js@3"></script><script>docsearch({
+	  gtag('config', 'UA-126807198-1');</script><title>Timber&#92;​TextHelper – Timber v2 – Timber Documentation</title><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta http-equiv="x-ua-compatible" content="ie=edge"><meta name="docsearch:version" content="v2"><link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@docsearch/css@3"><link rel="stylesheet" href="/docs/build/css/styles.css?id=c9d85857d742479204d190fd66fabaf1"><link rel="stylesheet" href="/docs/build/css/mobile.css?id=eb03f5e9c806ca82b2fc8d728401461a" media="screen and (max-width: 979px)"><script src="/docs/build/js/app.js?id=4594e1490acc2ce9d471fb2243cbcfce" defer="defer"></script><link rel="icon" href="/docs/build/favicons/favicon.ico" type="image/x-icon"><link rel="apple-touch-icon-precomposed" sizes="57x57" href="/docs/build/favicons/apple-touch-icon-57x57.png"><link rel="apple-touch-icon-precomposed" sizes="114x114" href="/docs/build/favicons/apple-touch-icon-114x114.png"><link rel="apple-touch-icon-precomposed" sizes="72x72" href="/docs/build/favicons/apple-touch-icon-72x72.png"><link rel="apple-touch-icon-precomposed" sizes="144x144" href="/docs/build/favicons/apple-touch-icon-144x144.png"><link rel="apple-touch-icon-precomposed" sizes="60x60" href="/docs/build/favicons/apple-touch-icon-60x60.png"><link rel="apple-touch-icon-precomposed" sizes="120x120" href="/docs/build/favicons/apple-touch-icon-120x120.png"><link rel="apple-touch-icon-precomposed" sizes="76x76" href="favicons/apple-touch-icon-76x76.png"><link rel="apple-touch-icon-precomposed" sizes="152x152" href="favicons/apple-touch-icon-152x152.png"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-196x196.png" sizes="196x196"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-96x96.png" sizes="96x96"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-32x32.png" sizes="32x32"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-16x16.png" sizes="16x16"><link rel="icon" type="image/png" href="/docs/build/favicons/favicon-128.png" sizes="128x128"><meta name="application-name" content="Timber Documentation"><meta name="msapplication-TileColor" content="#FFFFFF"><meta name="msapplication-TileImage" content="/docs/build/favicons/mstile-144x144.png"><meta name="msapplication-square70x70logo" content="/docs/build/favicons/mstile-70x70.png"><meta name="msapplication-square150x150logo" content="/docs/build/favicons/mstile-150x150.png"><meta name="msapplication-wide310x150logo" content="/docs/build/favicons/mstile-310x150.png"><meta name="msapplication-square310x310logo" content="/docs/build/favicons/mstile-310x310.png"><meta name="twitter:card" content="summary_large_image"><meta name="twitter:site" content="@TimberWP"><meta name="twitter:title" content="Timber for WordPress Documentation"><meta name="twitter:description" content="Create WordPress themes with beautiful OOP code and the Twig Template Engine"><meta name="twitter:image" content="https://repository-images.githubusercontent.com/7413451/06c62480-b95c-11ea-8b35-b5dd97d070f1"></head><body><header class="header"><div class="logoContainer"><a href="/docs/"><img src="/docs/build/img/timber-logo.svg" alt="Timber Logo" style="width: 105px; height: 30px; border: 0" role="img"></a></div><div class="search"><div id="docsearch"></div></div><nav class="navTop" id="nav-top"><ul><li><a href="https://upstatement.com/timber/" target="_blank" rel="noreferrer noopener">About Timber</a></li><li><a href="https://twig.symfony.com/doc/" target="_blank" rel="noreferrer noopener">Twig Docs</a></li><li><a href="https://opencollective.com/timber" target="_blank" rel="noreferrer noopener">Sponsor us</a></li><li><a href="https://github.com/timber/timber" target="_blank" rel="noreferrer noopener"><img src="/docs/build/img/github.png" alt="Star on Github" style="width: 29px; height: 29px; border: 0"></a></li></ul></nav><button class="navMobileToggle js-menu-open" type="button" id="nav-mobile-toggle"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 34"><path d="M45.6,19.43H2.4a2.43,2.43,0,0,1,0-4.86H45.6a2.43,2.43,0,0,1,0,4.86Z"/><path d="M45.6,4.86H2.4A2.41,2.41,0,0,1,0,2.43,2.41,2.41,0,0,1,2.4,0H45.6A2.41,2.41,0,0,1,48,2.43,2.41,2.41,0,0,1,45.6,4.86Z"/><path d="M45.6,34H2.4a2.43,2.43,0,0,1,0-4.86H45.6a2.43,2.43,0,0,1,0,4.86Z"/></svg> <span class="sr-only">Menu</span></button></header><div class="wrapper"><aside class="sidebar slideup-menu" id="sidebar" data-turbolinks-keep-scroll-position><button class="navClose js-menu-close" type="button"><div class="navClose-icon" aria-hidden="true"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48"><path d="M3.43,48A3.43,3.43,0,0,1,1,42.15L42.15,1A3.43,3.43,0,1,1,47,5.85L5.85,47A3.4,3.4,0,0,1,3.43,48Z"/><path d="M44.57,48a3.4,3.4,0,0,1-2.42-1L1,5.85A3.43,3.43,0,0,1,5.85,1L47,42.15A3.43,3.43,0,0,1,44.57,48Z"/></svg></div><span class="sr-only">Close Menu</span></button><nav class="navVersions"><ul><li><a href="/docs/v2/" class="is-current">v2.x</a></li><li><a href="/docs/v1/">v1.x</a></li></ul></nav><nav id="nav-main" class="navMain"><ul class="navMain-sections"><li class="navMain-section"><h3 class="navMain-title">Installation</h3><ul class="navMain-items"><li class="navMain-item" data-order="10"><a class="navMain-link" href="/docs/v2/installation/installation/">Installation</a></li><li class="navMain-item" data-order="30"><a class="navMain-link" href="/docs/v2/installation/manage-timber-with-composer/">Managing Timber with Composer</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Getting Started</h3><ul class="navMain-items"><li class="navMain-item" data-order="100"><a class="navMain-link" href="/docs/v2/getting-started/introduction/">Introduction</a></li><li class="navMain-item" data-order="200"><a class="navMain-link" href="/docs/v2/getting-started/template-inheritance-and-includes/">Template inheritance and includes</a></li><li class="navMain-item" data-order="300"><a class="navMain-link" href="/docs/v2/getting-started/a-single-post/">A single post</a></li><li class="navMain-item" data-order="400"><a class="navMain-link" href="/docs/v2/getting-started/a-post-archive/">A post archive</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Guides</h3><ul class="navMain-items"><li class="navMain-item" data-order="50"><a class="navMain-link" href="/docs/v2/guides/context/">Context</a></li><li class="navMain-item" data-order="75"><a class="navMain-link" href="/docs/v2/guides/template-locations/">Template Locations</a></li><li class="navMain-item" data-order="110"><a class="navMain-link" href="/docs/v2/guides/posts/">Posts</a></li><li class="navMain-item" data-order="120"><a class="navMain-link" href="/docs/v2/guides/terms/">Terms</a></li><li class="navMain-item" data-order="130"><a class="navMain-link" href="/docs/v2/guides/users/">Users</a></li><li class="navMain-item" data-order="140"><a class="navMain-link" href="/docs/v2/guides/comments/">Comments</a></li><li class="navMain-item" data-order="150"><a class="navMain-link" href="/docs/v2/guides/menus/">Menus</a></li><li class="navMain-item" data-order="160"><a class="navMain-link" href="/docs/v2/guides/widgets/">Widgets</a></li><li class="navMain-item" data-order="170"><a class="navMain-link" href="/docs/v2/guides/shortcodes/">Shortcodes</a></li><li class="navMain-item" data-order="200"><a class="navMain-link" href="/docs/v2/guides/twig/">Twig</a></li><li class="navMain-item" data-order="220"><a class="navMain-link" href="/docs/v2/guides/twig-filters/">Twig filters</a></li><li class="navMain-item" data-order="300"><a class="navMain-link" href="/docs/v2/guides/cookbook-text/">Text Cookbook</a></li><li class="navMain-item" data-order="400"><a class="navMain-link" href="/docs/v2/guides/escaping/">Escaping</a></li><li class="navMain-item" data-order="500"><a class="navMain-link" href="/docs/v2/guides/custom-page-templates/">Custom Page Templates</a></li><li class="navMain-item" data-order="600"><a class="navMain-link" href="/docs/v2/guides/custom-fields/">Custom Fields</a></li><li class="navMain-item" data-order="800"><a class="navMain-link" href="/docs/v2/guides/functions/">Functions</a></li><li class="navMain-item" data-order="1000"><a class="navMain-link" href="/docs/v2/guides/cookbook-images/">Image Cookbook</a></li><li class="navMain-item" data-order="1100"><a class="navMain-link" href="/docs/v2/guides/pagination/">Pagination</a></li><li class="navMain-item" data-order="1200"><a class="navMain-link" href="/docs/v2/guides/sidebars/">Sidebars</a></li><li class="navMain-item" data-order="1300"><a class="navMain-link" href="/docs/v2/guides/performance/">Performance/Caching</a></li><li class="navMain-item" data-order="1350"><a class="navMain-link" href="/docs/v2/guides/date-time/">Date/Time in Timber</a></li><li class="navMain-item" data-order="1400"><a class="navMain-link" href="/docs/v2/guides/internationalization/">Internationalization</a></li><li class="navMain-item" data-order="1500"><a class="navMain-link" href="/docs/v2/guides/cheatsheet/">Cheatsheet</a></li><li class="navMain-item" data-order="1550"><a class="navMain-link" href="/docs/v2/guides/gutenberg/">Block Editor (Gutenberg)</a></li><li class="navMain-item" data-order="1600"><a class="navMain-link" href="/docs/v2/guides/extending-timber/">Extending Timber</a></li><li class="navMain-item" data-order="1650"><a class="navMain-link" href="/docs/v2/guides/extending-twig/">Extending Twig</a></li><li class="navMain-item" data-order="1660"><a class="navMain-link" href="/docs/v2/guides/class-maps/">Class Maps</a></li><li class="navMain-item" data-order="1670"><a class="navMain-link" href="/docs/v2/guides/wp-cli/">WP-CLI</a></li><li class="navMain-item" data-order="1700"><a class="navMain-link" href="/docs/v2/guides/hosts-servers/">Hosts &amp; Servers</a></li><li class="navMain-item" data-order="1800"><a class="navMain-link" href="/docs/v2/guides/debugging/">Debugging</a></li><li class="navMain-item" data-order="1900"><a class="navMain-link" href="/docs/v2/guides/testing/">Automated Testing</a></li><li class="navMain-item" data-order="2000"><a class="navMain-link" href="/docs/v2/guides/routing/">Routing</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/guides/custom-integrations/">Custom Integrations</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/guides/woocommerce/">WooCommerce</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title navMain-sectionTitle">Reference</h3><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-archives/">Archives</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-attachment/">Attachment</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-cache-cleaner/">Cleaner</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-comment/">Comment</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-datetimehelper/">DateTimeHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-externalimage/">ExternalImage</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-helper/">Helper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-image/">Image</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-imagedimensions/">ImageDimensions</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-imagehelper/">ImageHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-menu/">Menu</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-menuitem/">MenuItem</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-pagesmenu/">PagesMenu</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-pagination/">Pagination</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-pathhelper/">PathHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-post/">Post</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-postarrayobject/">PostArrayObject</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-postexcerpt/">PostExcerpt</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-postquery/">PostQuery</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-site/">Site</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-term/">Term</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-texthelper/" aria-current>TextHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-theme/">Theme</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-timber/">Timber</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-urlhelper/">URLHelper</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/reference/timber-user/">User</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Hooks</h3><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/hooks/actions/">Action Hooks</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/hooks/filters/">Filter Hooks</a></li></ul></li><li class="navMain-section"><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/integrations/advanced-custom-fields/">Advanced Custom Fields</a></li></ul></li><li class="navMain-section"><h3 class="navMain-title">Upgrade Guides</h3><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/upgrade-guides/1.0/">Upgrade to 1.0</a></li><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/upgrade-guides/2.0/">Upgrade to 2.0</a></li></ul></li><li class="navMain-section"><ul class="navMain-items"><li class="navMain-item" data-order=""><a class="navMain-link" href="/docs/v2/contributing/">Contributing to Timber</a></li></ul></li></ul></nav></aside><div class="main-container"><div class="version-note"><p>You are reading the documentation for <strong>Timber v2.x</strong>. Switch to the documentation for Timber <a href="/docs/v1/">v1.x</a>.</p></div><main><article><h1>Timber&#92;​TextHelper</h1><aside><h2 class="heading-small">On this page</h2><nav class="toc"><ol><li><a href="#overview">Overview</a><ol><li><a href="#methods">Methods</a></li></ol></li><li><a href="#class-methods">Class Methods</a><ol><li><a href="#trim_characters">trim_characters()</a></li><li><a href="#trim_words">trim_words()</a></li><li><a href="#remove_tags">remove_tags()</a></li></ol></li></ol></nav></aside><div class="content"><p>Class provides different text-related functions commonly used in WordPress development</p><h2 id="overview" tabindex="-1">Overview <a class="directLink" href="#overview">#</a></h2><h3 id="methods" tabindex="-1">Methods <a class="directLink" href="#methods">#</a></h3><div class="table-methods"><table><thead><tr><th>Name</th><th>Return Type</th><th>Summary/Returns</th></tr></thead><tbody><tr><td><span class="method-name"><a href="#remove_tags">remove_tags()</a></span></td><td><span class="method-type"><code>null</code> or <code>string</code> or <code>string[]</code></span></td><td><span class="method-description"></span></td></tr><tr><td><span class="method-name"><a href="#trim_characters">trim_characters()</a></span></td><td><span class="method-type"><code>string</code></span></td><td><span class="method-description">Trims text to a certain number of characters.<br><br><span class="method-return"><span class="method-return-label">Returns:</span> trimmed text.</span></span></td></tr><tr><td><span class="method-name"><a href="#trim_words">trim_words()</a></span></td><td><span class="method-type"><code>string</code></span></td><td><span class="method-description"></span></td></tr></tbody></table></div><h2 id="class-methods" tabindex="-1">Class Methods <a class="directLink" href="#class-methods">#</a></h2><h3 id="trim_characters" tabindex="-1">trim_characters() <a class="directLink" href="#trim_characters">#</a></h3><p>Trims text to a certain number of characters.</p><p>This function can be useful for excerpt of the post As opposed to wp_trim_words trims characters that makes text to take the same amount of space in each post for example</p><p><strong>since</strong> 1.2.0</p><p><code>trim_characters( string $text, int $num_chars = 60, string $more = '&amp;hellip;' )</code></p><p><strong>Returns:</strong> <code>string</code> trimmed text.</p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$text</td><td><code>string</code></td><td>Text to trim.</td></tr><tr><td>$num_chars</td><td><code>int</code></td><td>Number of characters. Default is 60.</td></tr><tr><td>$more</td><td><code>string</code></td><td>What to append if $text needs to be trimmed. Defaults to '…'.</td></tr></tbody></table><hr><h3 id="trim_words" tabindex="-1">trim_words() <a class="directLink" href="#trim_words">#</a></h3><p><code>trim_words( string $text, int $num_words = 55, string|null|false $more = null, string $allowed_tags = 'p a span b i br blockquote' )</code></p><p><strong>Returns:</strong> <code>string</code></p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$text</td><td><code>string</code></td><td></td></tr><tr><td>$num_words</td><td><code>int</code></td><td></td></tr><tr><td>$more</td><td><code>string</code> or <code>null</code> or <code>false</code></td><td>text to appear in &quot;Read more...&quot;. Null to use default, false to hide</td></tr><tr><td>$allowed_tags</td><td><code>string</code></td><td></td></tr></tbody></table><hr><h3 id="remove_tags" tabindex="-1">remove_tags() <a class="directLink" href="#remove_tags">#</a></h3><p><code>remove_tags( mixed $string, array $tags = [] )</code></p><p><strong>Returns:</strong> <code>null|string|string[]</code></p><table><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>$string</td><td><code>mixed</code></td><td></td></tr><tr><td>$tags</td><td><code>array</code></td><td></td></tr></tbody></table><hr></div></article></main></div></div><script src="https://cdn.jsdelivr.net/npm/@docsearch/js@3"></script><script>docsearch({
     appId: '7REN4GR6X4',
     apiKey: '9acbf22ef9a9b117a0f9ba50bd2f4280',
     /**