Re is out: see what's new Lifetime updates on every purchase Support replies within 24 hours Secure checkout via Gumroad 8,500+ sales since 2016

↑↓ Navigate ↵ Open Esc Close

All products
Re:Maily contact form builder is now available on WordPress.org See it live

Config paths

Updated 3 min read 13 views

A layout’s settings are one array, $config in PHP, saved as JSON in the _forma_config meta. A path names one setting: layout.slider.speed is $config['layout']['slider']['speed']. forma.field and forma_select_options take these paths, and so do field conditions.

// In skin.php: a larger title on Metro grids
$tag = 'metro' === $config['layout']['type'] ? 'h2' : 'h3';

forma_item_part( 'title', $item, [ 'tag' => $tag ] );

Content

PathDefaultValues
query.sourceportfolioA source ID: a post type, media, or a taxonomy’s terms
query.per_page91 to 100, or -1 for all
query.orderby / query.orderdate / DESCThe source’s Order by options; ASC or DESC
query.offset0Items to skip
query.include / query.exclude / query.authors[]IDs
query.taxonomies / query.tax_relation[] / ORTerm IDs per taxonomy; AND or OR
query.search”Words to match
query.images / query.image_data[]Media source: image IDs, and each image’s own fields
query.media_title / query.media_descriptiontitle / captionWhich image field a Media item shows
query.skip_shown, query.top_level, query.hide_emptyfalse, false, trueToggles

Layout

PathDefaultValues
layout.typegridgrid, masonry, metro, justified, freeform, slider, a theme’s type
layout.{type}.ratio, ratio_tablet_landscape, ratio_tablet, ratio_mobile4:3 (freeform auto), ”Image ratio per device; ” takes the wider device’s
layout.{type}.fitcovercover or contain
layout.metro.pattern (+ per device) / layout.metro.tileclassic / imageA Metro pattern; tile size by image or card
layout.justified.row_height260 / 200 / 150Per device: desktop, tablet_landscape, tablet, mobile
layout.justified.stretch_lastfalse
layout.freeform.patternscatteredA Freeform pattern
layout.slider.effectslideslide, fade, coverflow
layout.slider.arrows, dots, loop, centered, free_scroll, free_scroll_sticky, autoplay, pause_on_hovertrue, true, then falseToggles
layout.slider.height / height_static / height_dynamic / min_heightdynamic / 300 / 80 / ”Sizing; static in px, dynamic in %, min height any CSS length
layout.slider.delay / speed5000 / 500Milliseconds
responsive.columns3 / – / 2 / 1Per device, 1 to 12 (auto for a slider); null takes the wider device’s
responsive.gap_x / responsive.gap_y30Per device, 0 to 200 px

Toolbar and pagination

PathDefaultValues
filters.enabled / taxonomy / template / all_label / show_countfalse / ” / default / ” / falseThe filter
search.enabled / template / placeholderfalse / ” / ”The search
sort.enabled / template / options / default_labelfalse / dropdown / four orders / ”Sorting for visitors
pagination.typenonenone, numbers, loadmore
pagination.template, align, load_more_label, loading_label, no_more_label, hide_end, scroll_offsetPagination’s look and text
display.attach_controlstruePrint the controls with the grid
toolbar, toolbar_tablet_landscape, toolbar_tablet, toolbar_mobileemptyPlaces 1-left … 2-right, each a list of search, filters, sort

Cards and clicks

PathDefaultValues
skindefaultA card style ID
click.actionopenopen, lightbox, none
click.target / click.rel”'', _blank, _top; rel words
click.title / click.descriptionitem / excerptWhat the lightbox caption shows
animation.effectfade-upnone or a forma_animations key
animation.duration / stagger / out_duration / out_stagger500ms / 60ms / 300ms / 30msTimes
extra.skin_{id}.{field}A skin’s settings.php fields
extra.{section}.{field}Fields added with forma_controls

Forma Pro

These paths exist only while Forma Pro runs.

PathDefaultValues
query.more_sources, query.manual, query.date.*, query.with_image, query.no_sticky, query.meta.*, query.meta_order.*Also show, manual order, date and custom field filters
layout.typeAdds marquee and list
layout.{type}.ratio_custom5:4The custom ratio
layout.marquee.speed / direction / scroll_reverse / pause_on_hover / drag60 / left / false / true / trueThe Marquee layout
layout.list.*preview, preview_width, preview_radius, preview_ratio, preview_effect, focus
pagination.typeAdds infinite
click.protect, video.mode, inserts, proofing.*Image protection, video play mode, inserts, client proofing
Was this article helpful?