{"id":1896587,"date":"2019-10-18T13:19:32","date_gmt":"2019-10-18T17:19:32","guid":{"rendered":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/creating-translations-for-events-using-wpml-2\/"},"modified":"2022-03-11T07:41:07","modified_gmt":"2022-03-11T12:41:07","slug":"creating-translations-for-events-using-wpml","status":"publish","type":"post","link":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/creating-translations-for-events-using-wpml\/","title":{"rendered":"WPML Translations"},"content":{"rendered":"\n<p>Once WPML is\u00a0set up<a href=\"https:\/\/staging.theeventscalendar.com\/knowledgebase\/k\/setting-up-the-events-calendar-with-wpml\/\" target=\"_blank\" rel=\"noreferrer noopener\"> and configured<\/a>\u00a0to work with The Events Calendar, you can show your calendar in different languages. This article reviews some important tips for using the two plugins together.<\/p>\n\n\n\n<p class=\"has-text-color has-background\" style=\"background-color:var(--global-palette8);color:#141827\">\ud83d\udca1 This article assumes some familiarity with using WPML. If you are new to WPML, you&#8217;ll want to review\u00a0their <a href=\"https:\/\/wpml.org\/documentation\/getting-started-guide\/\" target=\"_blank\" rel=\"noreferrer noopener\">Getting Started Guide<\/a> before moving on to translating events.<\/p>\n\n\n\n<p>When viewing the Events within your WordPress dashboard, you&#8217;ll now see the additional column for managing the translations.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2015\/08\/WPML-Column-665x73.png\" alt=\"Creating Translations for Events Using WPML: WPML Column\"\/><\/figure>\n\n\n\n<p>Just like when you&#8217;re creating translations for your posts or your pages, you can use any of the &#8220;+&#8221; signs to create the related translation for your events.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"Essstep\">Essential steps<\/h2>\n\n\n\n<p>There are some crucial things you will need to remember when creating translated\u00a0versions of your events:<\/p>\n\n\n\n<p><strong>Start by selecting the language of the event.<\/strong> This will dictate what the original language of the event will display as on the front end.<\/p>\n\n\n\n<p><strong>Select a translation priority.<\/strong> This will prioritize the translation work according to your project&#8217;s needs. You can read more about this <a href=\"https:\/\/wpml.org\/documentation\/translating-your-contents\/adding-priority-to-your-translations\/\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a>.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2022\/03\/Screen-Shot-2022-03-11-at-8.35.04-AM.png\" alt=\"Language options with WPML\" class=\"wp-image-1952240\"\/><\/figure>\n\n\n\n<p>After hitting that button, you might want to modify the title of the event <em>and<\/em> its permalink.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2022\/03\/Screen-Shot-2022-03-11-at-10.39.07-AM.png\" alt=\"Edit the permalink with WPML and The Events Calendar\" class=\"wp-image-1952251\"\/><\/figure>\n\n\n\n<p><\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"venandorg\">Venues and Organizers<\/h2>\n\n\n\n<p>There are still a few glitches in place when it comes&nbsp;to the interaction between our plugins and WPML with&nbsp;Venues and Organizers.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Known issues:<\/h3>\n\n\n\n<ol class=\"wp-block-list\"><li><strong>Organizer and Venue<\/strong>: Creating a new venue or a new organizer at the same time you are creating an event with WPML will result in the newly created venue or organizer to not be assigned a language for technical reasons. We recommend not doing that for now.<\/li><li><strong>Venue<\/strong>: Sometimes the&nbsp;Google&nbsp;map related to&nbsp;a venue might not display in alternate languages in the single event view. This issue only affects certain&nbsp;WordPress themes.<\/li><\/ol>\n\n\n\n<h3 class=\"wp-block-heading\">Workarounds<\/h3>\n\n\n\n<ol class=\"wp-block-list\"><li><strong>Organizer and Venue:&nbsp;<\/strong>Try creating Venues and Organizers and their translations&nbsp;<em>before<\/em> creating events. You can also create them after, but that will require going back in each event in all languages and manually assigning the Organizer and Venue.<\/li><li><strong>Venue<\/strong>: If you are experiencing issues displaying the Google map related to a venue in one or many languages, please ensure that the &#8220;use latitude +longitude&#8221; box&nbsp;is checked.<figure><a style=\"font-size: 0.875rem; background-color: #ffffff;\" href=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2015\/09\/uselatitudeandlongitude.png\"><img decoding=\"async\" src=\"https:\/\/images.theeventscalendar.com\/kb\/uploads\/2015\/09\/uselatitudeandlongitude.png\" alt=\"please ensure that the &quot;use latitude +longitude&quot; box&nbsp;is checked\"><\/a><\/figure><\/li><\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">Events Calendar Pro Recurring events<\/h2>\n\n\n\n<p>The recurring events feature in <a href=\"https:\/\/theeventscalendar.com\/product\/wordpress-events-calendar-pro\/\" target=\"_blank\" rel=\"noreferrer noopener\">Events Calendar Pro<\/a>\u00a04.3 and above supports\u00a0WPML translations. Earlier versions do not support WPML with recurring events.<\/p>\n\n\n\n<p>The procedure for dealing with recurring events is exactly the same as for normal events:<\/p>\n\n\n\n<ol class=\"wp-block-list\"><li>Create your event and recurrence rules in the site&#8217;s main language.<\/li><li>Follow the <a href=\"https:\/\/staging.theeventscalendar.com\/knowledgebase\/k\/creating-translations-for-events-using-wpml\/#Essstep\" target=\"_blank\" rel=\"noreferrer noopener\">essential steps<\/a><em><strong>\u00a0<\/strong><\/em>above for dealing with translations of those recurring events.<\/li><li>Make sure you have read about our issues with <a href=\"https:\/\/staging.theeventscalendar.com\/knowledgebase\/k\/creating-translations-for-events-using-wpml\/#venandorg\" target=\"_blank\" rel=\"noreferrer noopener\">Venues and Organizers<\/a>.<\/li><\/ol>\n\n\n\n<p><strong>Very important:&nbsp;<\/strong>in spite of the &#8220;You can safely navigate away&#8221; message, it is important that you do not switch language until the event series has been fully created.<\/p>\n\n\n\n<p>Otherwise, some of the recurring events will be created in the language you have switched to.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Translations in the WordPress admin<\/h2>\n\n\n\n<p>At this time, there are a few known instances where text related to events in the WordPress admin is missing translations. Those instances include:<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li><strong>Date and Time Format:<\/strong> This is located on the plugin Settings screen and includes the Date and Time Separator, Time Range Separator, and Compact Date Format settings.<\/li><li><strong>Advanced Template Settings:<\/strong> This is located on the same page just below the Date and Time Format settings. The two settings that allow you add content above and below the calendar do not respect WPML translations.<\/li><\/ul>\n\n\n\n<p>While there is no official fix for this, the WPML team has <a href=\"https:\/\/wpml.org\/errata\/the-events-calendar-admin-texts-do-not-translate\/\" target=\"_blank\" rel=\"noreferrer noopener\">documented a workaround<\/a> that adds the following snippet to a theme&#8217;s <code>functions.php<\/code> file:<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: php; title: ; notranslate\" title=\"\">\nadd_filter(&#039;tribe_get_single_option&#039;, &#039;tribe_options_multilingual&#039;, 20, 3);\n\nfunction tribe_options_multilingual( $option, $default, $option_name ) {\n  if (is_string($option)) {\n    return apply_filters( &#039;wpml_translate_single_string&#039;, $option, &#039;admin_texts_tribe_events_calendar_options&#039;, &#039;&#x5B;tribe_events_calendar_options]&#039; . $option_name);\n  } else {\n    return $option;\n  }\n}\n<\/pre><\/div>\n\n\n<h2 class=\"wp-block-heading\">Other tips<\/h2>\n\n\n\n<p>There are many options available to you when using the WPML plugin. This can be a great thing when it comes to customizing that feature for your site. However, this does create a few problems with compatibility since we&#8217;re unable to comply with every option that is available within the WPML plugin. You may find that using certain&nbsp;settings may cause your calendar and associated events to behave in strange ways that you do not like.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Once WPML is\u00a0set up and configured\u00a0to work with The Events Calendar, you can show your calendar in different languages. This article reviews some important tips for using the two plugins together. \ud83d\udca1 This article assumes some familiarity with using WPML. If you are new to WPML, you&#8217;ll want to review\u00a0their Getting Started Guide before moving&#8230;<\/p>\n","protected":false},"author":3,"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":[46,128],"tags":[92],"stellar-product-taxonomy":[158,161],"class_list":["post-1896587","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-integrations","category-languages-translations","tag-translations","stellar-product-taxonomy-events-calendar-pro","stellar-product-taxonomy-the-events-calendar"],"acf":[],"taxonomy_info":{"category":[{"value":46,"label":"Integrations"},{"value":128,"label":"Languages &amp; Translations"}],"post_tag":[{"value":92,"label":"Translations"}],"stellar-product-taxonomy":[{"value":158,"label":"Events Calendar Pro"},{"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":"Jaime Marchwinski","author_link":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/author\/jaimetri-be\/"},"comment_info":0,"category_info":[{"term_id":46,"name":"Integrations","slug":"integrations","term_group":0,"term_taxonomy_id":46,"taxonomy":"category","description":"","parent":0,"count":115,"filter":"raw","term_order":"0","cat_ID":46,"category_count":115,"category_description":"","cat_name":"Integrations","category_nicename":"integrations","category_parent":0},{"term_id":128,"name":"Languages &amp; Translations","slug":"languages-translations","term_group":0,"term_taxonomy_id":128,"taxonomy":"category","description":"","parent":61,"count":8,"filter":"raw","term_order":"0","cat_ID":128,"category_count":8,"category_description":"","cat_name":"Languages &amp; Translations","category_nicename":"languages-translations","category_parent":61}],"tag_info":[{"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\/1896587","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\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/comments?post=1896587"}],"version-history":[{"count":1,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1896587\/revisions"}],"predecessor-version":[{"id":1956237,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/1896587\/revisions\/1956237"}],"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=1896587"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/categories?post=1896587"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/tags?post=1896587"},{"taxonomy":"stellar-product-taxonomy","embeddable":true,"href":"https:\/\/staging.theeventscalendar.com\/knowledgebase\/wp-json\/wp\/v2\/stellar-product-taxonomy?post=1896587"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}