{"id":1896507,"date":"2019-10-18T13:19:18","date_gmt":"2019-10-18T17:19:18","guid":{"rendered":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/change-the-wording-of-any-bit-of-text-or-string-2\/"},"modified":"2022-03-14T15:05:11","modified_gmt":"2022-03-14T19:05:11","slug":"change-the-wording-of-any-bit-of-text-or-string","status":"publish","type":"post","link":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/change-the-wording-of-any-bit-of-text-or-string\/","title":{"rendered":"Custom Wording in the Calendar"},"content":{"rendered":"\n

The featured snippet here will help you change any piece of text in The Events Calendar and its add-ons. With a little bit of modification, it would even allow you to change the wording of any piece of text anywhere in WordPress, not just this plugin!<\/p>\n\n\n\n

First copy\/paste the snippet at the bottom of this page<\/a> to your theme’s functions.php. You may need to remove the opening <?php<\/strong> tag if your theme’s functions.php already has one.<\/p>\n\n\n\n

This snippet already contains two wording changes, which you can use as a template for the changes you want to make. This changes the phrase “Related Events” to “Similar Events” and “Venue” to “Location.” This is the magic bit right here:<\/p>\n\n\n

\n$custom_text = [\n  'Venue' => 'Location',\n  'Related %s' => 'Similar %s',\n];\n<\/pre><\/div>\n\n\n
To change a particular set of text, you must first copy it exactly as it appears in the code<\/em>. Frequently it appears the same on the front-end. For instance, to change the wording of “Related Events” to say “Similar Events”, you can simply copy the text from the front end. You will then paste it as a key inside of the $custom_text array inside of the snippet as in the above example. You can add as many lines as you want by following the same pattern.<\/p>\n\n\n\n
\"KB<\/figure>\n\n\n\n
Sometimes the text you want to change cannot be copy-pasted from the front end. For instance, by default, the label in the Events Bar<\/a> has a CSS style that transforms <label>s to all caps. If we copy-pasted “SEARCH” or “WEEK OF” they will not replace the text we want, because that is not how they appear in the code. If we inspect these elements we will see something like this:<\/p>\n\n\n
\n<label>Search<\/label>\n<\/pre><\/div>\n\n\n
In order to change that label, we would have to copy it as it appears in the code<\/em>, namely “Search”, not “SEARCH”. An example which changes “Search” to “Find”:<\/p>\n\n\n
\n$custom_text = [\n  'Related %s' => 'Similar %s',\n  'Search' => 'Find', \n];\n<\/pre><\/div>\n\n\n
In the above examples, you may have been wondering what the %s<\/code> is all about. Those are placeholders for words that the translation does not change. So `Related %s` allows you to change the word “Events” (in the settings), but is not responsible for translating it – it only translates the word “Related”.<\/p>\n\n\n\n
\u26a0\ufe0f Note: On rare occasions, this can be even more complicated when multiple strings are concatenated together. An example would be a heading like “Events for the week of November 24, 2014.” When attempting to edit these it might become necessary to dive into the PHP code and determine how the individual strings appear in the code, and what their gettext<\/code> $text value<\/code> is.<\/p>\n\n\n\n
To help get more accurate translations, WordPress provides translations with context and translations for singular\/plural. These use slightly different filters to account for the extra information, and may not get caught by the gettext<\/code> filter. Since we use these in some places, we have included examples addressing these in the code below as well.<\/p>\n\n\n\n
And here is the full snippet:<\/p>\n\n\n
\n<?php\n\n\/*\n * EXAMPLE OF CHANGING ANY TEXT (STRING) IN THE EVENTS CALENDAR\n * See the codex to learn more about WP text domains:\n * http:\/\/codex.wordpress.org\/Translating_WordPress#Localization_Technology\n * Example Tribe domains: 'tribe-events-calendar', 'tribe-events-calendar-pro'...\n *\/\n\n\/**\n * Put your custom text here in a key => value pair\n * Example: 'Text you want to change' => 'This is what it will be changed to'.\n * The text you want to change is the key, and it is case-sensitive.\n * The text you want to change it to is the value.\n * You can freely add or remove key => values, but make sure to separate them with a comma.\n * This example changes the label "Venue" to "Location", "Related Events" to "Similar Events", and "(Now or date) onwards" to "Calendar - you can discard the dynamic portion of the text as well if desired.\n*\/\nfunction tribe_replace_strings() {\n\t$custom_text = [\n\t\t'Venue' => 'Location',\n\t\t'Related %s' => 'Similar %s',\n\t\t'%s onwards' => 'Calendar',\n\t];\n\n\treturn $custom_text;\n}\n\n\n\nfunction tribe_custom_theme_text ( $translation, $text, $domain ) {\n\t\/\/ If this text domain doesn't start with "tribe-", "the-events-", or "event-" bail.\n\tif ( ! check_if_tec_domains( $domain ) ) {\n\t\treturn $translation;\n\t}\n\n\t\/\/ String replacement.\n\t$custom_text = tribe_replace_strings();\n\n\t\/\/ If we don't have replacement text in our array, return the original (translated) text.\n\tif ( empty( $custom_text[$translation] ) ) {\n\t\treturn $translation;\n\t}\n\n\treturn $custom_text[$translation];\n}\n\n\n\nfunction tribe_custom_theme_text_plurals ( $translation, $single, $plural, $number, $domain ) {\n\t\/\/ If this text domain doesn't start with "tribe-", "the-events-", or "event-" bail.\n\tif ( ! check_if_tec_domains( $domain ) ) {\n\t\treturn $translation;\n\t}\n\n\t\/** If you want to use the number in your logic, this is where you'd do it.\n\t * Make sure you return as part of this, so you don't call the function at the end and undo your changes!\n\t *\/\n\n\t\/\/ If we're not doing any logic up above, just make sure your desired changes are in the $custom_text array above (in the `tribe_custom_theme_text` filter. )\n\tif ( 1 === $number ) {\n\t\treturn tribe_custom_theme_text ( $translation, $single, $domain );\n\t} else {\n\t\treturn tribe_custom_theme_text ( $translation, $plural, $domain );\n\t}\n}\n\n\n\nfunction tribe_custom_theme_text_with_context ( $translation, $text, $context, $domain ) {\n\t\/\/ If this text domain doesn't start with "tribe-", "the-events-", or "event-" bail.\n\tif ( ! check_if_tec_domains( $domain ) ) {\n\t\treturn $translation;\n\t}\n\n\t\/** If you want to use the context in your logic, this is where you'd do it.\n\t * Make sure you return as part of this, so you don't call the function at the end and undo your changes!\n\t * Example (here, we don't want to do anything when the context is "edit", but if it's "view" we want to change it to "Tribe"):\n\t * if ( 'edit' === strtolower( $context ) ) {\n\t *    return $translation;\n\t * } elseif( 'view' === strtolower( $context ) ) {\n\t *    return "Tribe";\n\t * }\n\t *\n\t * Feel free to use the same logic we use in tribe_custom_theme_text() above for key => value pairs for this logic.\n\t *\/\n\n\t\/\/ If we're not doing any logic up above, just make sure your desired changes are in the $custom_text array above (in the `tribe_custom_theme_text` filter. )\n\treturn tribe_custom_theme_text ( $translation, $text, $domain );\n}\n\n\n\nfunction tribe_custom_theme_text_plurals_with_context ( $translation, $single, $plural, $number, $context, $domain ) {\n\t\/\/ If this text domain doesn't start with "tribe-", "the-events-", or "event-" bail.\n\tif ( ! check_if_tec_domains( $domain ) ) {\n\t\treturn $translation;\n\t}\n\n\t\/**\n\t * If you want to use the context in your logic, this is where you'd do it.\n\t * Make sure you return as part of this, so you don't call the function at the end and undo your changes!\n\t * Example (here, we don't want to do anything when the context is "edit", but if it's "view" we want to change it to "Tribe"):\n\t * if ( 'edit' === strtolower( $context ) ) {\n\t *    return $translation;\n\t * } elseif( 'view' === strtolower( $context ) ) {\n\t *    return "cat";\n\t * }\n\t *\n\t * You'd do something as well here for singular\/plural. This could get complicated quickly if it has to interact with context as well.\n\t * Example:\n\t * if ( 1 === $number ) {\n\t *    return "cat";\n\t * } else {\n\t *    return "cats";\n\t * }\n\t * Feel free to use the same logic we use in tribe_custom_theme_text() above for key => value pairs for this logic.\n\t *\/\n\n\t\/\/ If we're not doing any logic up above, just make sure your desired changes are in the $custom_text array above (in the `tribe_custom_theme_text` filter. )\n\tif ( 1 === $number ) {\n\t\treturn tribe_custom_theme_text ( $translation, $single, $domain );\n\t} else {\n\t\treturn tribe_custom_theme_text ( $translation, $plural, $domain );\n\t}\n}\n\nfunction check_if_tec_domains( $domain ) {\n\t$is_tribe_domain = strpos( $domain, 'tribe-' )      === 0;\n\t$is_tec_domain   = strpos( $domain, 'the-events-' ) === 0;\n\t$is_event_domain = strpos( $domain, 'event-' )      === 0;\n\n\t\/\/ If this text domain doesn't start with "tribe-", "the-events-", or "event-" bail.\n\tif ( ! $is_tribe_domain && ! $is_tec_domain && ! $is_event_domain ) {\n\t\treturn false;\n\t}\n\n\treturn true;\n}\n\n\/\/ Base.\nadd_filter( 'gettext', 'tribe_custom_theme_text', 20, 3 );\n\/\/ Plural-aware translations.\nadd_filter( 'ngettext', 'tribe_custom_theme_text_plurals', 20, 5 );\n\/\/ Translations with context.\nadd_filter( 'gettext_with_context', 'tribe_custom_theme_text_with_context', 20, 4 );\n\/\/ Plural-aware translations with context.\nadd_filter( 'ngettext_with_context', 'tribe_custom_theme_text_plurals_with_context', 20, 6 );\n<\/pre><\/div>","protected":false},"excerpt":{"rendered":"
The featured snippet here will help you change any piece of text in The Events Calendar and its add-ons. With a little bit of modification, it would even allow you to change the wording of any piece of text anywhere in WordPress, not just this plugin! First copy\/paste the snippet at the bottom of this page…<\/p>\n","protected":false},"author":17,"featured_media":1955565,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_swpsp_post_exclude":false,"_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"ep_exclude_from_search":false,"footnotes":""},"categories":[79],"tags":[20,25,58,92],"stellar-product-taxonomy":[161],"class_list":["post-1896507","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-snippets","tag-code","tag-customizations","tag-php","tag-translations","stellar-product-taxonomy-the-events-calendar"],"acf":[],"taxonomy_info":{"category":[{"value":79,"label":"Snippets"}],"post_tag":[{"value":20,"label":"Code"},{"value":25,"label":"Customizations"},{"value":58,"label":"PHP"},{"value":92,"label":"Translations"}],"stellar-product-taxonomy":[{"value":161,"label":"The Events Calendar"}]},"featured_image_src_large":["https:\/\/images.theeventscalendar.com\/kb\/uploads\/2023\/02\/social-share-1024x538.png",1024,538,true],"author_info":{"display_name":"Andras Guseo","author_link":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/author\/andras\/"},"comment_info":0,"category_info":[{"term_id":79,"name":"Snippets","slug":"snippets","term_group":0,"term_taxonomy_id":79,"taxonomy":"category","description":"","parent":0,"count":136,"filter":"raw","term_order":"0","cat_ID":79,"category_count":136,"category_description":"","cat_name":"Snippets","category_nicename":"snippets","category_parent":0}],"tag_info":[{"term_id":20,"name":"Code","slug":"code","term_group":0,"term_taxonomy_id":20,"taxonomy":"post_tag","description":"","parent":0,"count":33,"filter":"raw","term_order":"0"},{"term_id":25,"name":"Customizations","slug":"customizations","term_group":0,"term_taxonomy_id":25,"taxonomy":"post_tag","description":"","parent":0,"count":177,"filter":"raw","term_order":"0"},{"term_id":58,"name":"PHP","slug":"php","term_group":0,"term_taxonomy_id":58,"taxonomy":"post_tag","description":"","parent":20,"count":128,"filter":"raw","term_order":"0"},{"term_id":92,"name":"Translations","slug":"translations","term_group":0,"term_taxonomy_id":92,"taxonomy":"post_tag","description":"","parent":0,"count":16,"filter":"raw","term_order":"0"}],"_links":{"self":[{"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1896507","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/users\/17"}],"replies":[{"embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/comments?post=1896507"}],"version-history":[{"count":1,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1896507\/revisions"}],"predecessor-version":[{"id":1956305,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1896507\/revisions\/1956305"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/media\/1955565"}],"wp:attachment":[{"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/media?parent=1896507"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/categories?post=1896507"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/tags?post=1896507"},{"taxonomy":"stellar-product-taxonomy","embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/stellar-product-taxonomy?post=1896507"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}