RockOn Woo Variations Table

Admin page

Everything lives under WooCommerce → Variations Table , for anyone who can manage WooCommerce (store managers included).

• Overview — the last 30 days at a glance (adds from tables, units added, paid orders and revenue that came from tables, each compared with the 30 days before), every page, post, template or pattern that holds a table with links to edit or view it, and a check of WooCommerce, WordPress and PHP versions.
• Shortcode builder — pick products by name, or categories and tags, choose a layout, columns, filters and options, and copy the shortcode. A live preview shows the table as you go. The shortcode only names what differs from your defaults.
• Settings — store-wide defaults that every table and block follows unless it sets its own: “basket” or “cart” wording, layout, filters, hiding out-of-stock items, linking product names, grid paging and whether grid products start closed. Also the number of variations sent with the page, usage statistics on or off, and whether deleting the plugin deletes its data.
• Help — a quick start, the full shortcode reference and the developer hooks.

Usage statistics and privacy

When statistics are on (the default), the plugin keeps daily totals for 90 days: how many add-to-basket actions came from a table, how many items and units they added, and how many paid orders and how much revenue included them. Revenue is each order line’s share that was added from a table, after discounts and before tax; refunds are not taken off. No personal data is stored: no customer, IP address or order details, only the totals. A table add is marked on the basket line, copied to the order line as hidden meta ( _rwvt_qty ) at checkout, and counted once when the order is paid. Statistics can be switched off or deleted under Settings.

Shortcode

Basic use:

[rovartable id="12,34,56"]

Choosing products

• id — comma separated product IDs, rendered in the order given.
• category — comma separated product category slugs.
• tag — comma separated product tag slugs.
• attribute + terms — a product attribute slug and its term slugs, e.g. attribute="colour" terms="red,blue" .
• exclude — product IDs to leave out.
• categories_exc — category slugs to leave out.
• limit — maximum number of products (0 = no limit).
• orderby — date , title , menu_order , ID , rand or modified . Default date .
• order — ASC or DESC . Default DESC . id takes priority: when it is set, the category, tag and attribute filters are ignored.

Controlling the table

• columns — comma separated, in display order. Available: image , title , sku , attributes , price , stock , quantity , button . Default title,attributes,price,stock,quantity,button .
• thead — custom header labels, comma separated, replacing the defaults in order.
• caption — a visible caption above the table.
• class — extra CSS classes on the wrapper.
• link_titles — yes (default) or no .
• add_all — yes to show an “Add selected to basket” button. Default no .
• disabled — yes renders a read-only table with no dropdowns, quantity fields or basket buttons. Default no .

Bulk order grid

[rovartable layout="grid" category="workwear" per_page="10"]

• layout — table (default) shows one row per product, with a dropdown for each option. grid shows one row per variation, grouped under a header row for each product.
• per_page — grid only: products per page. A product’s variations always stay together on one page. 0 (default) lists every product on one page.
• collapsed — grid only: yes (default) starts each product closed, so the grid reads as a list of products; click a product’s header row to open it. no starts them open.

In the grid, typing a quantity ticks the row, and ticking a row fills in its minimum quantity. The checkbox in the header selects every available row on the current page, and the one beside each product name selects all of that product’s variations and opens the product. A summary bar counts the selected items, units and subtotal, and stays at the bottom of the screen while anything is selected.

“Add selected to basket” adds everything in one request. If an item cannot be added, for example because there is not enough stock, its row stays ticked and shows the reason, and the rest are still added; a closed product opens to show it. Out-of-stock variations are listed but cannot be ticked. A variation that accepts any value for an attribute shows a dropdown for just that attribute.

Grid columns default to attributes,sku,price,stock,quantity , because the product name and image already appear in each header row. Add image to show each variation’s own image, or button for a basket button on every row.

Filters

[rovartable layout="grid" category="workwear" filters="all"]

• filters — controls to show above the table, comma separated: attribute slugs such as colour or size (a dropdown each, listing only values the table’s products have), attributes for every attribute, search (matches product name, SKU and option names) and stock (“In stock only”). all shows every one. Default: none.
• hide_out_of_stock — yes hides out-of-stock items when the page loads. With the stock filter shown, its box starts ticked and shoppers can untick it. Default no .

Filtering is instant and needs no page reload. A count shows how many rows match, with a “Clear filters” link.

In the grid, filters work on variations: “Size: L” lists only the L variations, products without a size are hidden, and a variation that accepts any value for an attribute matches every value. Closed products open while you search or filter by an option and fold away again when the filters are cleared. “Select all” only selects rows that match, and anything already ticked stays ticked when a filter hides it.

In the dropdown table, filters work on whole products: a product is listed if it offers the chosen value. The chosen value is also filled into each listed product’s dropdown, so “Size: L” leaves every product set to L, but a dropdown the shopper has already changed is left alone.

Examples

[rovartable id="12,34" thead="Product,Colour,Size,Price,Stock,Qty,Basket"] [rovartable category="t-shirts" limit="10" orderby="title" order="ASC" columns="image,title,sku,attributes,price,quantity,button" add_all="yes"] [rovartable attribute="colour" terms="red" caption="Everything in red"]<h3>Hooks</h3>

Filters:

• rwvt_product_ids — the resolved product ID list for a table.
• rwvt_table_columns — the resolved column definitions.
• rwvt_table_filters — the controls shown in the filter bar.
• rwvt_render_custom_column — render a custom column’s cell.
• rwvt_no_products_message — the output when a table matches nothing.
• rwvt_script_settings — the configuration handed to the front-end script.
• rwvt_ajax_variation_threshold — inline variation payload cut-off.
• rwvt_grid_max_rows — the most variation rows one bulk order grid renders (default 1000).
• rwvt_bulk_max_items — the most items one “Add selected to basket” request may add (default 200).

Upgrading from version 6

Your existing shortcodes keep working. [rovartable id="12,34"] and [rovartable id="12,34" thead="Title,Colour,Size,Basket"] render the same columns they always did.

A shortcode that supplies thead keeps the version 6 column set (title, one column per attribute, then basket), because thead labels are positional and adding the new columns would shift every label onto the wrong one. To take the new Price, Stock and Qty columns, name them explicitly:

[rovartable id="12,34" columns="title,attributes,price,stock,quantity,button" thead="Product,Colour,Cost,Availability,Amount,Basket"]

Shortcodes without thead gain the new columns automatically.

Two behaviour changes to be aware of

• disabled was accepted but never did anything in version 6. It now renders a read-only table. If you had disabled on a shortcode, remove it unless you want that.
• categories_exc was also accepted and ignored. It now genuinely excludes those categories.

Custom CSS

These version 6 hooks are unchanged: .ron-woo-table-section , tbody.row-hover , tr.row-