CartTrigger – BAG

CartTrigger – BAG

توسط

CartTrigger – BAG (Brand · Awards · Gallery) extends the WooCommerce native brand taxonomy with three powerful modules:

Custom Fields

Attach unlimited key–value pairs to any brand. Output them anywhere via shortcode or PHP helper function. CSS classes are fully customisable, including Tailwind arbitrary-value classes (e.g. text-[11px]).

Awards

Manage a list of awards and recognitions for each brand — with optional logo, award name, event name, and year. Display them as a styled list using the [ctbag_awards] shortcode.

Gallery

Upload a curated image gallery per brand. Display it as a responsive grid with the [ctbag_gallery] shortcode. Optional native WooCommerce lightbox (PhotoSwipe) via lightbox="1".

Shortcodes

[ctbag_custom_fields]
Outputs brand custom fields as a <dl> list.

[ctbag_custom_fields brand="slug" wrapper_class="..." dt_class="..." dd_class="..."]

[ctbag_awards]
Outputs brand awards as a styled card list.

[ctbag_awards brand="slug" title="Awards" wrapper_class="..." card_class="..."]

[ctbag_gallery]
Outputs brand gallery as a responsive image grid.

[ctbag_gallery brand="slug" title="Gallery" wrapper_class="..." lightbox="1"]

PHP Helper Functions

All shortcodes are also available as direct PHP functions that bypass WordPress’ shortcode parser — useful when Tailwind arbitrary-value classes (e.g. text-[11px]) would otherwise be mangled:

echo ctbag_custom_fields(['wrapper_class' => 'grid grid-cols-2 gap-4']);
echo ctbag_awards(['title' => __('Awards', 'your-textdomain')]);
echo ctbag_gallery(['title' => __('Gallery', 'your-textdomain'), 'lightbox' => '1']);

Professional Admin UI

All brand meta fields are presented in a clean, card-based admin interface grouped by module (HTML Description, Custom Fields, Awards, Gallery), with collapsible shortcode reference built in. Custom fields and awards support drag & drop reordering. Gallery images can be removed individually (× button on hover) and reordered by dragging.

  1. Upload the carttrigger-bag folder to the /wp-content/plugins/ directory.
  2. Activate the plugin through the Plugins menu in WordPress.
  3. Go to Products Brands and edit any brand to start adding content.

سوالات متداول

Does this plugin require WooCommerce?

Yes. WooCommerce must be active before activating CartTrigger – BAG. The plugin declares a Requires Plugins: woocommerce dependency.

Does it require a specific WooCommerce version?

WooCommerce 8.0 or higher is recommended. The plugin has been tested up to WooCommerce 10.6.1.

Can I use Tailwind CSS classes in the shortcode attributes?

Yes, but classes containing square brackets (e.g. text-[11px]) will be interpreted as shortcode closing tags by WordPress. Use the PHP helper functions instead — they bypass the shortcode parser entirely.

Where is the gallery lightbox loaded?

The lightbox uses WooCommerce’s bundled PhotoSwipe library. It is only active when lightbox="1" is set. On pages where WooCommerce scripts are disabled, a graceful fallback (open image in new tab) is used automatically.

Gallery images look blurry or load slowly — what image size should I use?

The size_thumb parameter controls which registered WordPress image size is used for gallery thumbnails. The default is medium_large (typically 768 px wide), which is appropriate for large single-column layouts. If your gallery is displayed in a multi-column grid (3–4 columns), use size_thumb="medium" (300 px) to reduce file weight by 4–6× with no visible quality loss:

[ctbag_gallery size_thumb="medium" lightbox="1"]

Or via PHP helper:

echo ctbag_gallery(['size_thumb' => 'medium', 'lightbox' => '1']);

Brand pages load slowly — any caching recommendations?

Brand taxonomy pages contain no user-specific content (no cart, no session), so they are ideal candidates for full-page caching. Make sure your caching plugin (LiteSpeed Cache, WP Rocket, W3 Total Cache…) does not exclude brand taxonomy pages from its cache.

Since version 2.0.8, PhotoSwipe (4 CSS/JS files) is only enqueued on brand pages that actually have a gallery, so brands without a gallery already load significantly fewer assets.

If you use LiteSpeed Cache and notice that brand pages are slow after a product update, check whether “Smart Purge on Product Update” is purging brand taxonomy pages. Enabling the LiteSpeed Crawler ensures the cache is regenerated automatically in the background so visitors never hit an uncached page.

×
نظری برای این آیتم موجود نیست.
0 0 رای ها
امتیازدهی
اشتراک در
اطلاع از
0 نظرات
قدیمی‌ترین
تازه‌ترین بیشترین رأی
هیچ نسخه‌ای برای این آیتم موجود نیست.
بدون امتیاز

قیمت:

رایگان

نگارش

آخرین انتشار

17 اردیبهشت 1405

آخرین بروزرسانی

3 ماه پیش

نصب های فعال

-

نگارش وردپرس

وردپرس 6.3+

تست شده از نسخه

وردپرس 6.9.4

نگارش PHP

PHP 7.4+

نسخه ها

0 نسخه