PP Flatsome Helper

WordPress/WooCommerce plugin for Progressive Parts. Home for theme and layout changes to the Flatsome child theme that are too large for functions.php or that have to coordinate with other plugins.

What it does (v1.0.6)

All of it applies to single product pages only.

Breadcrumb rules

• Starts with an unlinked Parts label. Top-level product categories (Parts, Brand, Universal) are structural containers, so the label stands in for whichever root the chosen category lives under and roots are never linked.
• Then the category chain (root excluded), each crumb linked to its archive.
• The category is the Rank Math primary category when it is eligible, otherwise the deepest eligible category on the product (ties keep alphabetical order).
• Categories under the Brand tree are never used (pp_flatsome_helper_breadcrumb_excluded_roots, matched by slug).
• The product itself is added to the schema as the final ListItem but is not printed; the H1 sits directly beneath.
• Schema: the trail is returned from rank_math/frontend/breadcrumb/items, so Rank Math's BreadcrumbList matches the visible nav. The Parts label has no URL and is flagged hide_in_schema, so it is left out of the JSON-LD (Google requires an item URL on every entry except the last).

Rank Math settings that must stay as they are: General Settings > Breadcrumbs > Enable breadcrumbs function = ON (it gates the BreadcrumbList schema). Its Home / separator / "hide post title" options no longer affect product pages because the plugin supplies the whole trail. Flatsome's Rank Math > Breadcrumb Customizer toggle can stay on; the plugin removes the theme's summary breadcrumb regardless.

The Additional Information table

One table, shaped entirely through the core woocommerce_display_product_attributes filter (priority 20), so third parties can adjust rows through the same filter at a later priority:

1. Manufacturer: the product's category under the top-level Brand container (matched by slug, pp_flatsome_helper_brand_root_slug), linked to the brand archive. It replaces the pa_brand global attribute, which is being retired; until that attribute is removed or hidden, both rows show.
2. WooCommerce's own rows: weight with the shipping class in brackets, e.g. 0.35 kg (PP-EP5), then dimensions and visible attributes. A product without a displayed weight does not show its shipping class at all; it is not worth a row of its own.
3. SKU and Tags last. Categories are left out on purpose: the breadcrumb trail and the Manufacturer row already cover them.

SKU and variations

The SKU line is not a summary-priority hook: Reviews.io registers its rating snippet at summary priority 5 at plugin include time, which no later registration can precede, so the line is printed from woocommerce_after_template_part the moment WooCommerce's title template part finishes. Whatever else is queued at priority 5 now follows the SKU.

The SKU line and the table's SKU cell both use WooCommerce's product_meta / sku classes. WooCommerce's variation script updates .product_meta .sku when a variation is chosen, so both update live with no script of our own. Variable products without a parent SKU show N/A until a variation is picked, as WooCommerce's own meta template does.

Hooks

Filters:

Actions kept from the functions.php original (the child theme's data-sheet output uses pp_product_info_col_top): pp_product_description_col_top, pp_product_description_col_bottom, pp_product_info_col_top, pp_product_info_col_bottom.

Migrated out of functions.php (2026-09-30)

• "RankMath breadcrumb Fix" items filter and the woocommerce_product_meta_end breadcrumb hook (source of the brand crumb).
• display_product_shipping_class() on woocommerce_product_meta_end (now a Meta Info row).
• move_rank_math_breadcrumbs() (dead: it tested for a function that is a class method, so it never ran).
• pp_restructure_description_tab() / pp_description_tab_two_column() (now PP_Flatsome_Helper_Product_Tabs).

Verifying without a browser

php -l <file>                                   # lint every changed file
wp plugin list | grep pp-flatsome-helper        # active + version

See CLAUDE.md for a wp eval that prints the trail for one product. Staging is IP-locked, so the visual check is a browser test on a product page: trail above the H1, SKU beneath it, Meta Info under the attributes table in the description tab, and the BreadcrumbList in the page's JSON-LD.