Aptoma DrEdition Integration
8 min
aptoma dredition integration the aptoma integration connects purple hub to aptoma dredition https //aptoma com/ , enabling print editors to browse and place hub articles directly inside dredition's print layout tool purple hub acts as a content source aptoma fetches articles from purple, and editors lay them out in dredition's layoutpreview prerequisites an active aptoma dredition license with a ready to connect instance administrator access to purple hub (optional) purple dam with the print images feature enabled, for high resolution print file delivery setup go to all settings → purple ds hub settings and activate the enable aptoma integration checkbox this makes the settings → aptoma page available the aptoma settings page contains all configuration instructions, credentials, and json snippets needed to complete the connection on the aptoma side follow the instructions there features item labels colored badges shown on each article card in dredition's article browser you can configure which fields they display (post id, character count, status, acf fields) and their colors whenever you change the item labels, the content schema in aptoma dredition needs to be re imported the settings page will warn you and provide the updated schema to copy block mapping controls how each wordpress block type is converted when purple delivers an article to layoutpreview each element (title, excerpt, featured image, inline images, custom blocks) can be set to figure — exported as a standalone named component, referenced by identifier in your dredition layout template in text — exported as part of the flowing body text omit — excluded from the export configure the identifier names to match your dredition template live layout updates when an article is saved in purple hub, purple automatically notifies aptoma so dredition can re render the layoutpreview immediately — without the print editor having to refresh requires the aptoma api key to be entered on the settings page print image variants if an image has a print variant set up in purple dam, purple passes the high resolution print file url to aptoma alongside the web image dredition uses this to place the correct file in the layout requires the print images feature to be active — see print images docid\ lfwf bbbygycztmy81wpm metadata styling in layoutpreview acf field values and wordpress taxonomy terms are automatically added as css class names on the article's \<article> element in layoutpreview html this lets dredition template designers style layouts differently per section, category, or any other metadata — without any extra configuration class name format fieldname value , lowercased and hyphenated for example, an article with acf field ressort = "nachbarschaft" and category stadtleben gets class="ressort nachbarschaft category stadtleben" for instructions on creating acf fields, see create custom fields in purple hub docid\ sfolj8v8qcn3m3jibzbuk print planning view when data sync is enabled on the settings page, an aptoma planning item appears in the purple hub admin menu it shows which articles are placed in which aptoma edition, along with page number and placement dimensions, synced from the aptoma api the data is kept up to date via a webhook — setup instructions are on the settings page