ID PLUGIN

⌘K
  2. Home
  4. Docs
  6. ID PLUGIN
  8. WCFM Extentions
  10. WCFM WCFM Features — Admin Guide

WCFM WCFM Features — Admin Guide

This page lets you harden the vendor UI, simplify the WordPress media modal, control product notices on draft/pending items, customize the notice colors, and enable a couple of marketplace-wide behaviors (vendor-in-URL structure and a “Check Request” payout method).

Product Field Tweaks (WCFM Vendor UI)

Scope: WCFM vendor dashboard and wp-admin product editor (only when “Field Tweaks (master)” is ON)

  • Enable Field Tweaks (master)
    Master switch. When ON, the JS tweaks load on vendor product screens. If OFF, the four controls below do nothing.
  • Hide Stock Controls
    Hides stock quantity / stock status fields in the product edit UI. Useful if stock is centralized elsewhere and vendors shouldn’t adjust it.
  • Hide Variation Controls
    Hides the UI for adding/removing variations and variation-level settings. Keeps catalog structure stable.
  • Read-only: Price-related fields
    Prevents edits to regular/sale/other price fields (the inputs are visually present but locked). Protects pricing integrity.
  • Read-only: SKU & Second SKU
    Prevents edits to SKU fields (including your custom “Second SKU” meta). Ensures identifiers don’t drift.
  • Commission Max (Basic commission)
    Caps the “basic commission” value vendors can enter. Any attempt to exceed this value is blocked by the UI logic.
    Default: 3.00 (you can set decimals; cannot be negative).

Tip: These are client-side controls intended to prevent accidental or casual changes. If you need hard enforcement, add server-side validation too.

Media Modal Cleanup

Scope: WordPress media modal rendered inside WCFM (vendor dashboard & wp-admin)

  • Trim Media Modal (hide compat/details/tabs)
    Cleans up clutter inside the media modal. When enabled, it:
    • hides “compatibility” panels;
    • hides “attachment display settings”;
    • removes Gallery/Playlist tabs;
    • hides delete controls inside modals;
    • hides file size for images whose filename contains frame or image_xe.
      This keeps the vendor focused on picking the right image and avoids destructive actions in the media UI.

Product Status Notice (Draft/Pending)

Scope: Frontend single product pages

  • Show Notice on Draft/Pending Products
    If the current product’s status is draft or pending, a floating pill appears:
    “Preview Only — Publish to make purchases”
    This is helpful on staging or when preview links are exposed.
  • Disable Add-to-Cart on Draft/Pending
    When draft/pending, the single product page’s “Add to Cart” button is disabled (dimmed + not-allowed cursor). Prevents accidental test orders.
  • Notice Background Color / Notice Text Color
    Color pickers that override the notice’s default colors. Changes are applied via inline CSS, on top of the plugin’s base stylesheet:
    • Base file: assets/css/wcfm-draft-notice.css
    • Inline override is injected when the feature is ON.

Heads-up: These controls do not depend on the “Field Tweaks (master)” switch; you can use them independently.

Vendor Product URLs

Scope: Frontend product permalinks, site-wide

  • Enable Vendor in Product URLs
    When ON, product URLs include the vendor’s user slug (author nicename).
    Example pattern: /shop/{vendor}/product/{product-slug}Requirements:
    1. In WooCommerce → Settings → Permalinks → Product permalinks, choose Custom base and include the token %vendor_name%, e.g.
      • /shop/%vendor_name%/product
      • /store/%vendor_name%/items
      • /hub/%vendor_name%/p
    2. After enabling the toggle and saving permalinks, URLs will generate with the vendor inserted.
    3. The plugin adds the needed rewrite tag/rule so requests resolve properly.

Notes:
• You can use any base, not just /shop/, as long as your custom product base contains %vendor_name%.
• We do a one-time automatic rewrite flush when this feature first turns ON. If you change the base later, visit Settings → Permalinks and click Save once to refresh rules.

Vendor Payout Options

Scope: WCFM Marketplace → Vendors → Withdraw → Payment Methods

  • Enable “Check Request” Payout Option
    Adds a new withdrawal method labeled “Check Request” (internally keyed as brain_tree to integrate with WCFM’s gateway naming convention). Vendors will see a single “Email and Address” textarea in their billing settings (with your note: “Limit: One Request Quarterly; Gift Card option available”).
    When a withdrawal is initiated with this method:
    • the withdrawal meta stores amount, currency, and the vendor’s entered contact text;
    • there’s no live API call — this is meant for offline processing (you cut a check or issue a gift card).

Admin workflow: Approve vendor withdrawal requests as usual. The stored meta gives you the info you need to fulfill checks/gift cards.

How Saving Works (why toggles “stick”)

All toggle fields include a hidden 0 plus a checkbox 1. This means OFF is explicitly posted as 0, preventing the “checkbox not present” issue. The Settings API then sanitizes & persists 1/0 per key.

Where Things Live (for developers)

  • Module:
    modules/wcfm-js-controls.php (admin page, settings, enqueue, feature hooks)
  • JS (Field Tweaks + Media Modal):
    assets/js/wcfm-field-tweaks.js
    (Receives TCS_WCFM_TWEAKS config via wp_localize_script.)
  • CSS (Draft/Pending notice base):
    assets/css/wcfm-draft-notice.css
    (Colors overridden inline from the color pickers.)

Common Troubleshooting

  • Vendor URLs 404
    Make sure Product permalink base includes %vendor_name%, then visit Settings → Permalinks and click Save. Ensure the Vendor in Product URLs toggle is ON.
  • Notice doesn’t show
    The notice only appears on single product pages whose status is draft or pending. Published products won’t show it. Also confirm the feature toggle is ON.
  • Field Tweaks not applying
    These run on WCFM vendor dashboard and wp-admin product editor only when Enable Field Tweaks (master) is ON. Confirm the target screen matches.
  • Media modal not trimmed
    Ensure Trim Media Modal is ON and you’re opening the modal within WCFM or the product editor (the cleanup looks for the modal’s selectors).
  • Check Request not visible to vendors
    Make sure Enable “Check Request” Payout Option is ON. Vendors then fill the “Email and Address” field in their billing settings. This method is designed for offline processing (no payment API).

Safety & Side-Effects

  • All UI lock/trim features are non-destructive (no data loss), and primarily client-side.
  • URL changes affect SEO and existing links; enable Vendor URLs only if you plan to keep that structure.
  • “Check Request” creates a new withdrawal method but does not touch other gateways.

How can we help?