Aptoma DrEdition Integration

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 print placement lets editors flag where in print an article belongs — its edition, a placement code, a priority, and a slot size — and sends that as a dedicated "placement" block in the content source feed, separate from the item labels "data" block, so dredition's placement bot can auto place articles without manual work enable it via its own toggle on the aptoma settings page this adds a placement panel to every post's editor sidebar, and registers a dedicated taxonomy for maintaining the available placement codes, manageable from the wordpress admin like any other taxonomy the panel also lets you assign the article to one of the synced product editions; that's used to route the article into the right per edition feed rather than being part of the placement block itself beyond the built in placement fields, any number of additional acf or taxonomy fields can be picked to include in the placement block too, the same way fields are picked for item labels above 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 omit, keep children — available for custom blocks only the block's own wrapper is dropped, but the blocks nested inside it are still processed by their own mapping use this for container/wrapper blocks when you want to map their children individually but not export the wrapper itself block mapping applies at every nesting level, not only to top level blocks a child block is matched by its own block name wherever it appears, so a block nested inside another can be mapped independently — for example, exported as a figure while its parent block flows in text a block set to figure is pulled out of its parent's body flow into its named component (it is not duplicated in both places) to drop a purely structural wrapper block while still mapping the blocks inside it, set the wrapper to omit, keep children 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 image focus point & cropping when an image in an article has a crop rectangle or focus point set in purple, that information is forwarded to aptoma as the image's area of interest (aoi) aptoma's smart crop uses it to position and crop the image in the print layout, so the editorially chosen subject and framing are preserved instead of a naive centre crop a focus point without a crop is valid, aptoma falls back to the full image as the rectangle and uses the focus point as the crop centre if an image has neither a crop nor a focus point, no area of interest data is sent and aptoma applies its default behaviour no configuration is required, the data is included automatically whenever the article is sent to aptoma for setting crops and focus points, see image cropping in purple hub docid 4kwwqwnqkjo pr9yxuy02 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 monitoring view when data sync is enabled on the settings page, an aptoma monitoring 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 manual sync is also possible jumping from hub to aptoma once an article has been placed in an aptoma edition, purple hub shows clickable print placements chips that link straight to the corresponding edition and page in aptoma dredition each chip is labelled with the product and edition; hovering it reveals a tooltip with the placement position clicking a chip opens the placement in aptoma in a new browser tab the chips appear in two places editor sidebar — in the article editor, a "print placements" section lists the editions the current article is placed in post overview — a "print placements" column shows the same chips for every article (enable it via the column settings, see set columns in overview pages docid\ xv f9i59othora1dk7nge ) the post overview also offers a print placements filter each filter option shows a product and edition; applying it lists every article that was added to that exact edition, whether or not it has already been placed on a page jumping from aptoma to hub the same works in the other direction dredition can show an "open in purple hub" button on every hub article — both in the content source list of a page plan and on articles that have already been placed on a page clicking it opens that article in the hub editor in a new browser tab this button is not created automatically, it has to be set up once per dredition instance as a uri template the aptoma settings page in the hub lists the exact values to enter — role, source name, label and the url template, ready to copy — under "link back to the hub" in its setup instructions