Skip to content

BeFree Gantry 1.2.0

Choose a tag to compare

View all tags
@if-boop if-boop released this 04 Nov 07:34
v1.2.0
2ff6197
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

BeFree Gantry 1.2.0

Install: download befree-gantry-1.2.0.zip below and upload it in Appearance > Themes > Add New > Upload Theme. Check it against befree-gantry-1.2.0.zip.sha256.

Features

  • Latest Posts Slider for the free MetaSlider plugin: includes/latest-slider.php, the Latest Posts Slider particle (particles/latest-slider.*) and the [befree_latest_slider] shortcode.
    • The theme keeps one MetaSlider slideshow, BeFree Latest Posts, in sync with the latest 20 published posts that have a featured image, newest first. Each slide uses the featured image, has the post title as its caption and links to the post.
    • The slides rebuild automatically when a post is published, updated, unpublished or deleted, or its featured image changes. Slides you add to that slideshow by hand are kept.
    • It runs edge to edge from 360px phones to 3840px 4K. The image fills the band at 2.4:1 on desktop, capped at 1600px tall, and taller on phones. The caption scales with the screen. Colors use --bf-slideshow-bg and --bf-gold.
  • Wide sections (scss/befree-gantry/_wide.scss): add the CSS class bf-wide to a section (gear menu > CSS Classes) and its content sits in a centered 1600px container. It shrinks normally below 1600px. The width is --bf-wide-max.

Filters

  • befree_latest_slider_count: number of posts (default 20).
  • befree_latest_slider_settings: the MetaSlider settings the theme manages (flex, 1920×800, cropMultiply 2, slide effect, 6s delay, arrows and dots).

Backward compatibility

  • Existing layouts and outlines are unchanged. The shipped layout presets don't add the particle, and no section gets bf-wide unless you add it.
  • Without MetaSlider active, the particle and the shortcode print nothing.
  • The full-width overrides only apply when the Slideshow section contains the slider (#g-slideshow:has(.befree-latest-slider)). Other Slideshow content keeps its padding and container.
  • Style presets, the Sister Site particle, the chart and TradingView rules, and the Base-preset inheritance from 1.1.1 are unchanged.
  • SCSS clamp() values that mix units are wrapped in unquote(), because Gantry's scssphp can't evaluate mixed units.

Homepage only

To show the slider only on the homepage, put the particle in the Home outline (assigned to the front page) and leave the Base outline's Slideshow empty. Every other page then uses Base with no slider. For a wide story area, add bf-wide to the Home outline's Showcase, Feature, Main container and Subfeature sections.

Requirements

  • Gantry 5 framework: 5.6.5 recommended (includes the CVE-2026-110889 fix), minimum 5.5.
  • MetaSlider (free) for the slider. Tested with 3.114.0.

Tested on iw.je

Test setup: WordPress 7.1.4, PHP 8.4, Gantry 5.6.5, MetaSlider 3.114.0, BeFree Navy (preset3), 20 test posts (19 with featured images, so 19 slides).

Viewport Slider width Slide height Content width (bf-wide) Horizontal scroll
390×844 390 242 390 none
1440×900 1440 600 — none
1920×1080 1920 — 1600 none
3840×2160 3840 1600 1600 none

The slides came out newest first. Inner pages and posts use the Base outline with no slider. The main container there stays at 1200px.

Package

befree-gantry-1.2.0.zip, SHA-256 4d6dde1b9b5e64b1658751f8e47e699e5eab812b3e82eab91215ff1f486a59b8

Assets 4
Loading