You must create the resources to import with your theme. You can create resources from scratch and/or bring in resources that you’ve already created. You can leverage your HTML (basic web content), JSON (structures), or VM or FTL (templates) files with the Resource Importer. All web content articles require a structure and optionally a template. Note that some articles may share the same structure and perhaps even the same template—this is the case for all basic web content articles. Follow these steps to prepare your web content articles:
-
Select Edit from the article’s options menu, click the Options icon at the top right of the page and select View Source. Copy the article’s raw XML into an XML file locally. Create a folder for the article under
resources-importer/journal/articles/and rename it as desired. The web content article’s XML fills in the data required by the structure. An example web content article’s XML is shown below:<?xml version="1.0"?> <root available-locales="en_US" default-locale="en_US"> <dynamic-element name="content" type="text_area" index-type="keyword" index="0"> <dynamic-content language-id="en_US"> <![CDATA[ <center> <p><img alt="" src="[$FILE=space-program-history.jpg$]" /></p> </center> <p>In the mid-20th century, after two of the most violent wars in history, mankind turned its gaze upwards to the stars. Instead of continuing to strive against one another, man choose instead to strive against the limits that we had bound ourselves to. And so the Great Space Race began.</p> <p>At first the race was to reach space--get outside the earth's atmosphere, and when that had been reached, we shot for the moon. After sending men to the moon, robots to Mars, and probes beyond the reaches of our solar system, it seemed that there was nowhere left to go.</p> <p>The Space Program aims to change that. Beyond national boundaries, beyond what anyone can imagine that we can do. The sky is not the limit.</p> ]]> </dynamic-content> </dynamic-element> </root> -
Download the web content article’s structure. Open the structure and click the Source tab to view the structure’s file. Copy and paste its contents into a new JSON file in the
resources-importer/journal/structures/folder. The structure JSON sets a wireframe, or blueprint, for an article’s data. If you’re saving a basic web content article, you can copy the structure below (replaceen_USwith your language):{ "availableLanguageIds": [ "en_US" ], "defaultLanguageId": "en_US", "fields": [ { "label": { "en_US": "Content" }, "predefinedValue": { "en_US": "" }, "style": { "en_US": "" }, "tip": { "en_US": "" }, "dataType": "html", "fieldNamespace": "ddm", "indexType": "text", "localizable": true, "name": "content", "readOnly": false, "repeatable": false, "required": false, "showLabel": true, "type": "ddm-text-html" } ] } -
Download the structure’s matching template if it has one. Open the Actions menu for the structure and select Manage Templates to view the templates that use it. Create a folder for the template under
resources-importer/journal/templates/and copy and paste its contents into a new FTL file. The template defines how the data should be displayed. If you’re saving a basic web content article, you can copy the FreeMarker template below:${content.getData()}
Repeat the steps above for each web content article you have. Note that some web content articles may share the same structure and template; In these cases, only one copy of the structure and template is required for all web content articles that use them. Once your web content articles are saved, you can place them in their proper folder structure.