內容簡介
IngotForge Cards for ACF 外掛可將文章和 ACF 數據顯示為響應式卡片，提供多種佈局選擇，並支援 AJAX 分頁，讓網站內容更具互動性和可讀性。
【主要功能】
• 響應式卡片佈局：支援網格、列表及 Swiper 滑動佈局
• AJAX 分頁：提升使用者瀏覽體驗
• 多種 ACF 數據類型支援：文本、日期、分類等
• 篩選功能：依文章類型、分類及日期進行篩選
• 可見性控制：調整顯示的內容元素
• 自訂樣式：控制卡片的邊框、陰影及高度
外掛標籤
開發者團隊
原文外掛簡介
IngotForge Cards for ACF displays posts and ACF data as responsive cards. Version 1.6.5 retains [ingotforge_cards], existing shortcode defaults, and stored data.
Main features:
Grid, list, and accessible Swiper slider layouts.
AJAX pagination for grid and list layouts.
ACF text, textarea, date, taxonomy, post object, relationship, file, and common scalar return types.
Post type, taxonomy, meta, multiple-filter, and {today} date filtering.
The Events Calendar date, cost, venue, upcoming-event, and past-event support.
Visibility controls for images, titles, excerpts, ACF fields, taxonomy fields, dates, and document buttons.
Instance-container, card, image, typography, spacing, border, shadow, hover, and responsive-height controls.
Image-only cards and optional removal of image/title links.
Instance-scoped styles and slider controls for pages containing multiple shortcodes.
Conditional slider assets: Swiper loads only when a slider instance is rendered.
Keyboard, focus, status, reduced-motion, and error-handling improvements.
No analytics, tracking, telemetry, or external runtime asset requests.
The complete option reference and examples are available after activation under Settings > IngotForge Cards Manual and in SHORTCODE-REFERENCE.md inside the plugin package.
Examples
Responsive programme grid
[ingotforge_cards post_type="programme" fields="division,start_date" columns="3" per_page="9"]
Filtered document list
[ingotforge_cards post_type="document" layout="list" fields="description,pdf_documents_url,document_type" meta_filters="division:39175|document_type:32:LIKE" tax_filters="category:finance" per_page="6"]
Upcoming event cards
[ingotforge_cards post_type="tribe_events" fields="event_start_date,event_venue" event_display="upcoming" per_page="6"]
Responsive modern cards
[ingotforge_cards post_type="programme" fields="division" card_border_width="0" card_border_radius="18px" card_shadow="0 8px 28px rgba(15,23,42,.12)" card_hover_shadow="0 18px 44px rgba(15,23,42,.18)" card_height_desktop="440px" card_height_tablet="400px" card_height_mobile="auto"]
Accessible autoplay slider
[ingotforge_cards post_type="testimonial" layout="slider" fields="client_name,quote" slides_per_view="3" slider_autoplay="true" slider_delay="5000" slider_pause_on_hover="true" slider_pause_on_focus="true"]
Developer Integration
Optional extension points:
ingotforge_acf_cards_shortcode_args filters normalized shortcode arguments.
ingotforge_acf_cards_query_args filters final WP_Query arguments.
ingotforge_acf_cards_card_html filters each rendered card before the plugin’s final allowed-HTML pass.
ingotforge_acf_cards_asset_requirements filters styles detected before shortcode rendering.
ingotforge:cards:updated fires after successful AJAX pagination.
ingotforge:cards:slider-ready fires when a slider is initialized.
Trigger ingotforge:cards:refresh after dynamically inserting slider markup.
window.IngotForgeCards.loadPage(container, page) and window.IngotForgeCards.initSliders(context) are available for controlled integrations.
All approved ingotforge PHP identifiers, options, AJAX actions, handles, CSS prefixes, and shortcode names are retained.
Privacy
The plugin does not collect analytics, track users, create remote accounts, or send site content or personal data to an external service. Its front-end JavaScript communicates only with the site’s own WordPress AJAX endpoint when AJAX pagination is used.
Third-Party Library
Swiper v11.1.14 is bundled in assets/js/swiper-bundle.min.js and assets/css/swiper-bundle.min.css.
Project: Swiper
Source for the bundled version: Swiper 11.1.14 source
License: MIT
The files are served locally. The plugin does not contact the Swiper project or a CDN at runtime.
