{"id":308,"date":"2026-10-17T14:16:52","date_gmt":"2026-10-17T14:16:52","guid":{"rendered":"http:\/\/plugin-docs.com\/?post_type=doc&#038;p=308"},"modified":"2026-10-19T09:49:56","modified_gmt":"2026-10-19T09:49:56","slug":"understand-xml-configuration","status":"publish","type":"doc","link":"https:\/\/dragwyb.com\/docs\/understand-xml-configuration\/","title":{"rendered":"Understand XML Configuration"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">TranslateSense reads XML configuration to identify content fields that should be extracted for translation. The configuration groups rules by content type, so a Gutenberg block, an Elementor widget, and a Classic Editor custom field can each have different mapping rules.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Understand the main XML sections<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong><code>gutenberg-blocks<\/code><\/strong> contains rules for named Gutenberg blocks and their keys. For example, the default configuration maps the <code>content<\/code> key for <code>core\/paragraph<\/code>.<\/li>\n<li><strong><code>elementor-widgets<\/code><\/strong> contains widget rules and their fields. The default configuration maps fields such as a button&#8217;s <code>text<\/code> and nested <code>link&gt;url<\/code>.<\/li>\n<li><strong><code>custom-fields<\/code><\/strong> contains custom-field names that the Classic Editor mapping can process.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Review a builder&#8217;s configuration<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Open <strong>Languages \u2192 TranslateSense<\/strong> when Polylang is active, or <strong>Settings \u2192 TranslateSense<\/strong> otherwise.<\/li>\n<li>Select the relevant editor tab.<\/li>\n<li>Choose <strong>Edit [EDITOR] Config<\/strong> to open the configuration editor for that builder. The exact editor name appears in the button label.<\/li>\n<li>Review the block, widget, or field name and its mapped keys or paths before making a change.<\/li>\n<li>Select <strong>Save Config<\/strong> to save the configuration.<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">Validate and test changes<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">TranslateSense checks that the submitted configuration is non-empty and valid XML before saving it. A syntax error prevents the save and returns an error message. XML that passes syntax validation can still point to the wrong field, so test the relevant content after saving.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Configuration changes affect the rules used for later extraction. Before changing a shared builder configuration, keep a copy of the current XML and make a focused change rather than replacing unrelated rules.<\/p>\n\n\n\n\n<p class=\"wp-block-paragraph\">Screenshot to add: [TranslateSense editor tab and XML configuration editor]<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Learn what the XML configuration files describe.<\/p>\n","protected":false},"author":0,"featured_media":0,"parent":307,"menu_order":0,"template":"","class_list":["post-308","doc","type-doc","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc\/308","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc"}],"about":[{"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/types\/doc"}],"version-history":[{"count":1,"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc\/308\/revisions"}],"predecessor-version":[{"id":1294,"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc\/308\/revisions\/1294"}],"up":[{"embeddable":true,"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/doc\/307"}],"wp:attachment":[{"href":"https:\/\/dragwyb.com\/docs\/wp-json\/wp\/v2\/media?parent=308"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}