Steps for creating a blueprint that maintains a persistent connection wherever it is used.
Content Block
name
Outcome
rich-link-hovers
true
id
1042866408
class
tight manual-outcome-flex
Live Blueprints were introduced with Blueprint Maker 2.0+ and can be a sophisticated way to manage duplicate or similar content. Live Blueprints are particularly useful if you have a case where A) you want to re-use a common form of content (e.g. a table with similar headings but different values) and B) you want to be able to change that source form, from time to time, and ensure that these changes occur wherever the Blueprint is referenced.
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 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
language
js
{
"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 Blueprint
Navigate to, or create, a page where you want to use this Live Blueprint. Edit the page and insert the Live Blueprints Macro.
HTML Wrap
class
docs-screenshot
Image Modified
Image Added
In the first parameter, include the name of the Live Blueprint (this is the "name" field in your JSON file). For more about these parameters, read about the Live Blueprint Macro Parameters and Key. Save the macro edit screen.
HTML Wrap
class
docs-screenshot
Image Removed
If you have Theme Press, use the "Edit Blueprint" button
For users who also have Brikit Theme Press, press the "x" key on the page to toggle block editing mode. Under the Live Blueprint Macro, you will see a button that says "Edit Blueprint". Click it.
HTML Wrap
class
docs-screenshot
A modal window opens that resembles the Blueprint Wizard screen. Type in your unique values for each of the substitution fields.
HTML Wrap
class
docs-screenshot
Save your changes. You can update these values at any time by repeating this step.
Or, add substitution field values in the Live Blueprint Macro body
If 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 the value. Each substitution field gets a new line.
For example,
Code Block
language
text
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.
Content Block
name
Note
rich-link-hovers
true
id
495965127
class
manual-note-flex
collapsible
collapse
Note
If using:
Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
Add the tight-bottom class to the Steps block above to narrow the gap between the two blocks.
Content Block
name
Tip
rich-link-hovers
true
id
894522670
class
manual-tip-flex
collapsible
collapse
Tip
If using:
Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.
Content Block
name
Warning
rich-link-hovers
true
id
894530759
class
manual-warning-flex
collapsible
collapse
Warning
If using:
Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.
Content Block
name
Info
rich-link-hovers
true
id
894537203
class
manual-info-flex
collapsible
collapse
Info
If using:
Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.