Focused WordPress plugins for real client work.Clear licensing for 1, 5, or 100 websites
Dprime Plugins
CartBrowse plugins

Woo Product Condition help

Installation, usage, and technical reference for version 1.4.1.

Overview

Dprime Woo Product Condition adds a simple condition field to every WooCommerce product, such as New, Open Box, Refurbished, Used, or For Parts. You decide where the condition appears: as a text line on the single product page, as a badge on the product image, on the shop and category pages, and anywhere else through a shortcode.

Conditions are fully editable. Set your own labels and a color for each one, and the color is used for both the text and the image badge.

The plugin is free and connects with the rest of the Dprime plugin suite. When Dprime Woo Filters, Dprime Woo Product Importer, Dprime AI Smart Woo Chatbot, or Dprime Woo Wishlist are active, the condition flows into them automatically, and each connection can be turned off on the Integrations tab.

Before you start

  • WordPress 6.4 or newer
  • PHP 8.2 or newer
  • WooCommerce must be active

Installation

  1. Upload the plugin folder to the /wp-content/plugins/ directory, or install the zip through Plugins, Add New, Upload Plugin.
  2. Activate the plugin through the Plugins menu in WordPress.
  3. Open Woo Product Condition from the admin menu to set your conditions and display options.
  4. Edit a product, open the General tab in the Product data panel, and choose a condition.

Interface guide

Use these screens with the steps below. Select an image to open it at full size.

Woo Product Condition settings for single-product, shop, category, and appearance placement.
Place condition labels on product and archive pages, then adjust their visual treatment.

Using the plugin

  • A Condition field on the product General tab.
  • An editable list of conditions, each with a label, a color, and a Google value.
  • Show the condition as text on the single product page, with a choice of position.
  • Show the condition as a badge on the product image.
  • Show the condition text and badge on shop and category pages.
  • A dprime_condition shortcode with text and badge styles.
  • Integrations with the Dprime plugin suite, each with its own toggle.
  • A read only dprime_condition field on product REST responses.
  • Schema.org itemCondition in the product structured data.
  • Google Merchant Center compatibility through Google for WooCommerce or any feed plugin.
  • A CSS load toggle, a Custom CSS box, and a full class reference.
  • A developer API: dpwpc_get_condition, dpwpc_set_condition, dpwpc_badge_html, dpwpc_text_html.

Shortcodes

Use these in the WordPress editor, a shortcode block, or a compatible page builder.

[dprime_condition]

Styling and CSS classes

These public-facing class hooks are present in the plugin styles. Add custom CSS only after checking the result on a staging site.

.dpwpc-badge.dpwpc-badge--static.dpwpc-condition-label.dpwpc-condition-line.dpwpc-condition-value.woocommerce

Works with

These connections are covered by the release contract tests.

  • Woo Filters: Condition filtering and result metadata
  • Woo Wishlist: Condition details in private and shared wishlists
  • AI Smart Woo Chatbot: Product condition context inside store chat
  • Woo Product Importer: Extract and save product condition during import

Data and cleanup

  • 7 WordPress settings
  • Content metadata: _dpwpc_condition, _dpwpc_google_condition

Retention: kept until the plugin is uninstalled. Uninstall policy: delete the plugin-owned data declared above.

Troubleshooting

  1. Confirm the required WordPress, PHP, and companion-plugin versions above.
  2. Save the plugin settings again, then repeat the exact action that failed.
  3. Clear page, object, and browser caches when the issue affects front-end output.
  4. Temporarily test with unrelated plugins disabled on a staging site to identify a conflict.
  5. If the problem remains, record the steps, visible error, and relevant logs before contacting support.

Frequently asked questions

Does a product have to have a condition?

No. Products with no condition set show nothing, so you can leave the display options on without affecting other products.

Can I change the condition labels and colors?

Yes. Open the Conditions tab to add, rename, recolor, or remove conditions.

Where does the badge appear?

The badge sits in a corner of the product image on the single product page and, if enabled, on the shop and category images. You can choose the left or right corner. The shortcode can also render an inline badge anywhere.

How do I place the condition somewhere specific?

Use the dprime_condition shortcode. It reads the current product automatically, or takes an id attribute, and renders either the text line or an inline badge. The full attribute list is on the Help tab.

What do the integrations do?

When another Dprime plugin is active, the condition connects to it automatically: the badge shows in the Woo Filters grid, the importer can set the condition from the source page, the chatbot can answer condition questions, and the wishlist shows the condition next to saved items. Each connection has a toggle on the Integrations tab.

Can I set the condition on many products at once?

Yes. Select multiple products on the Products screen, choose Bulk Edit from the Bulk Actions menu, and a Condition field appears alongside the built in WooCommerce fields. This also keeps the Google Merchant value in sync when that setting is on.

Does this plugin require a Dprime subscription?

No. Dprime Woo Product Condition is free.

Updates and access

Download the complete plugin directly. Dprime Core can connect it to the public update catalogue.