Design the Blueprint with a mind towards how it will be used and reused on different pages. Add substitution fields in places where content will be different in each use of the Live Blueprint.
In the JSON file, the fields are all the same for defining Page Blueprints as they are for defining Live Blueprints, except for one: this is the "type" field. Be sure to set the value of "type" to "live". Then save and upload the JSON file. For example: Code Block |
---|
| {
"name" : "Expert Profile",
"description" : "A Live Blueprint for generating a common-form Expert Profile.",
"spaceKey" : "LIVEBLUEPRINTS",
"pageTitle" : "Expert Profile Live Blueprint",
"BlueprintFields" : [ "expert-name", "username", "pillar-name", "phone-number", "geographic-location", "building-name", "expert-title" ],
"type" : "live"
}, |
Reference the Live BlueprintNavigate to, or create, a page where you want to use this Live Blueprint Determine your use-caseLive Blueprints are particularly useful if you have a case where: a. You want to re-use a common 'form' of content, such as a table with similar headings but different values. and b. You want to be able to update that source form, from time to time, and ensure that these updates occur wherever the blueprint is referenced. Create a source blueprint with your content 'form'This page will act as the 'single source of truth' for the form of the blueprint. Any changes to this page will 'persist' to wherever this blueprint is referenced on the site. Therefore, design the page accordingly and with an eye towards how it will be used and reused in different places. Add substitution fieldsLive Blueprints can use any substitution fields, including built-in substitution fields. Navigate to the Blueprint Definitions PageEdit the JSON fileReference the live blueprintNow navigate to, or create, the page where you want to use (or 'reference' or 'activate') this live blueprint. Edit the page and insert the Live Blueprints Macro. Set the macro parametersPoint to the live blueprint in the macro parameters. "Edit the Blueprint" and add valuesRepeat as you see fit HTML Wrap |
---|
| Image Added |
In the first parameter, include the name of the Live Blueprint (this is the "name" field in your JSON file). Read about the other Live Blueprint Macro Parameters. Save the macro edit screen.
Press the "x" key on the page to toggle block editing mode. Under where you placed the Live Blueprint Macro, you will see a button that says "Edit Blueprint". Click it. HTML Wrap |
---|
| Image Added |
A modal window opens that resembles the Blueprint Wizard screen. Type in your unique values for each of the substitution fields then click "Save". You can update these values at any time by repeating this step. HTML Wrap |
---|
| Image Added |
Or, add substitution field values in the Live Blueprint Macro bodyIf you don't have Theme Press, edit the page and enter the unique substitution field values into the body of the Live Blueprint Macro. Enter the substitution field name followed by an equals sign ("=") and then the value. Each substitution field gets a new line. For example, Code Block |
---|
| phone-number=(123) 555-1234
geographic-location=St. Louis
pillar-name=SB-13
building-name=Milligan-23
expert-title=System Analyst
expert-name=Jane Smith
username=jane.smith |
You can update these values at any time by editing this macro body. Save the edit page screen.You can insert the Live Blueprint Macro on the page as many times and in as many places as you see fit, each will have their own
|