54 |
Migrations have only been tested in a local dev environment. Backup your DB before and while using migrations. Please report any issues you run into.
55 |
It is recommended leaving Automatic Import disabled until you have imported many times successfully with no issues or until the plugin has had some more real world testing.
56 |
Migrations are designed to be used with a single site only. Exported files store ID numbers of all exported data. When imported it will overwrite those IDs which could be different across sites. Using migrations to replicate models across sites is not the intended use.
57 |
58 |
59 |
60 |
Status
61 |
Migration file for import / export is located at: {{ jsonPath }}_master_.json.
62 |
If automatic import is enabled this is the file that will be loaded into the DB whenever the files modified time is newer than the last import time.
63 |
64 |
65 |
66 | | Automatic Import |
67 | {% if automation %}Enabled{% else %}Disabled{% endif %} |
68 | {% if automation %}{{ migrationsToggleForm(0, 'Disable') }}{% else %}{{ migrationsToggleForm(1, 'Enable') }}{% endif %} |
69 |
70 |
71 | | Last Export |
72 | {% if exportTime %}{{ exportTime|date("F d Y @ g:i a") }}{% else %}n/a{% endif %} |
73 | {{ quickActionForm('migrationExport', 'Run Export') }} |
74 |
75 |
76 | | Last Import |
77 | {% if importTime %}{{ importTime|date("F d Y @ g:i a") }}{% else %}n/a{% endif %} |
78 | {{ quickActionForm('migrationImport', 'Run Import') }} |
79 |
80 |
81 |
82 |
83 |
84 |
85 |
API
86 | {% if apiKey %}
87 | {% set apiExportUrl = siteUrl(craft.config.get('actionTrigger') ~ '/theArchitect/api/export', { key: apiKey }) %}
88 | {% set apiImportUrl = siteUrl(craft.config.get('actionTrigger') ~ '/theArchitect/api/import', { key: apiKey, force: false }) %}
89 |
90 |
91 |
92 | | {{ apiKey }} |
93 | {{ quickActionForm('generateKey', 'Generate New Key') }} |
94 |
95 |
96 | | {{ apiExportUrl }} |
97 | {{ clipboardButton(apiExportUrl) }} |
98 |
99 |
100 | | {{ apiImportUrl }} |
101 | {{ clipboardButton(apiImportUrl) }} |
102 |
103 |
104 |
105 | {% else %}
106 | {{ quickActionForm('generateKey', 'Generate Key') }}
107 | {% endif %}
108 |
109 |
110 |
111 | {% if dbAdditions|length > 0 %}
112 | {% include 'thearchitect/_itemTable' with {itemList: dbAdditions, status: 'success', headline: 'DB Additions', text: 'List of items added since the previous export. Performing an import will not delete these added fields.'} %}
113 | {% endif %}
114 | {% if dbUpdates|length > 0 %}
115 | {% include 'thearchitect/_itemTable' with {itemList: dbUpdates, status: 'warning', headline: 'DB Updates', text: 'List of items updated since the previous export. Performing an import will overwrite these changes prefering the exported model.'} %}
116 | {% endif %}
117 | {% if dbDeletions|length > 0 %}
118 | {% include 'thearchitect/_itemTable' with {itemList: dbDeletions, status: 'error', headline: 'DB Deletions', text: 'List if items deleted since the previous export. Performing an import will add these items back to the database.'} %}
119 | {% endif %}
120 | {% if modelAdditions|length > 0 %}
121 | {% include 'thearchitect/_itemTable' with {itemList: modelAdditions, status: 'success', headline: 'Model Additions', text: 'List if items added to the model since the previous import. Performing an import will create these items in the database.'} %}
122 | {% endif %}
123 | {% if modelUpdates|length > 0 %}
124 | {% include 'thearchitect/_itemTable' with {itemList: modelUpdates, status: 'warning', headline: 'Model Updates', text: 'List if items updated in the model since the previous import. Performing an import will modify existing items in the database.'} %}
125 | {% endif %}
126 | {% if modelDeletions|length > 0 %}
127 | {% include 'thearchitect/_itemTable' with {itemList: modelDeletions, status: 'error', headline: 'Model Deletions', text: 'List if items deleted from the model since the previous import. Performing an import will delete these items from the database.', subText: {Users: 'User deletions are not handled by The Architect please manually delete the users below to remove them.'}} %}
128 | {% endif %}
129 | {% if mismatch|length > 0 %}
130 |
Field Migration Problems
131 |
Problems listed below are preventing standard and automation imports from running. Please review changes before forcing an import.
132 |
133 |
134 |
135 | | Group |
136 | Name |
137 | Handle |
138 | Type |
139 |
140 |
141 |
142 | {% for fields in mismatch %}
143 |
144 | |
145 | {{ fields[0].group }}{% if fields[0].group != fields[1].group %} → {{ fields[1].group }}{% endif %}
146 | |
147 |
148 | {{ fields[0].name }}{% if fields[0].name != fields[1].name %} → {{ fields[1].name }}{% endif %}
149 | |
150 |
151 | {{ fields[0].handle }}{% if fields[0].handle != fields[1].handle %} → {{ fields[1].handle }}{% endif %}
152 | |
153 |
154 | {{ fields[0].type }} → {{ fields[1].type }}
155 | |
156 |
157 | {% endfor %}
158 |
159 |
160 | {{ quickActionForm('migrationImport', 'Force Import', { force: null }, true) }}
161 | {% endif %}
162 |
163 |