1. Home
  2. Knowledge Base
  3. WC Vendors
  4. Advanced Customization & Development
  5. Template Customization
  6. How to add custom product edit templates

How to add custom product edit templates

If your vendors sell more than one kind of product, a single product form rarely fits all of them. An auction listing needs different fields from a booking. This article shows you how to add your own product edit forms to the WC Vendors Pro vendor dashboard, so each product type gets the form it needs. Templates live in your theme’s template overrides, and WC Vendors Pro adds a button for each one to the vendor’s product screen automatically.

Prerequisites

  • WC Vendors Pro 1.4.0 or later.
  • A theme you can edit. Use a child theme so your templates survive theme updates.

Add a custom product template

  1. Create a wc-vendors/dashboard/ folder in your theme if it does not already exist.
  2. Copy the default product form into it and name the file product-{customname}.php, replacing {customname} with your own name.
  3. Add a Label: tag in the file header to set the button text. Without it, the button label is generated from the custom name.

In this example a new file has been added to the theme custom template overrides

  • product-mynewtemplate.php

Where the buttons appear

This will output the following add product buttons.

The result follows this URL format – /product/custom-name/edit. In this case, it would result in this – /product/mynewtemplate/edit.

Vendor dashboard products screen with add buttons for each custom product template
Add buttons generated for each custom product template

Template source example

This is the source code example of this template. 

<?php
/**
 * Use the label template tag to change the display label for your custom template
 *
 * Label: My New Template
 *
 * The template for displaying the Product edit form
 *
 * Override this template by copying it to yourtheme/wc-vendors/dashboard/
 *
 * @package    WCVendors_Pro
 * @version    1.6.2
 */
/**
 *   DO NOT EDIT ANY OF THE LINES BELOW UNLESS YOU KNOW WHAT YOU'RE DOING
 */
$title      = ( is_numeric( $object_id ) ) ? __( 'Save Changes', 'wcvendors-pro' ) : __( 'Add Product', 'wcvendors-pro' );
$page_title = ( is_numeric( $object_id ) ) ? __( 'Edit Product', 'wcvendors-pro' ) : __( 'Add Product', 'wcvendors-pro' );
$product    = ( is_numeric( $object_id ) ) ? wc_get_product( $object_id ) : null;
$post       = ( is_numeric( $object_id ) ) ? get_post( $object_id ) : null;
// Get basic information for the product
$product_title             = ( isset( $product ) && null !== $product ) ? $product->get_title() : '';
$product_description       = ( isset( $product ) && null !== $product ) ? $post->post_content : '';
$product_short_description = ( isset( $product ) && null !== $product ) ? $post->post_excerpt : '';
$post_status               = ( isset( $product ) && null !== $product ) ? $post->post_status : '';
/**
 *  Ok, You can edit the template below but be careful!
 */
?>
<h2><?php echo $page_title; ?></h2>
<?php do_action( 'wcvendors_before_product_form' ); ?>
<!-- Product Edit Form -->
<form method="post" action="" id="wcv-product-edit" class="wcv-form">
	<!-- Basic Product Details -->
	<div class="wcv-product-basic wcv-product">
		<?php do_action( 'wcv_before_product_details', $object_id ); ?>
		<!-- Product Title -->
		<?php WCVendors_Pro_Product_Form::title( $object_id, $product_title ); ?>
		<!-- Product Description -->
		<?php WCVendors_Pro_Product_Form::description( $object_id, $product_description ); ?>
		<!-- Product Short Description -->
		<?php WCVendors_Pro_Product_Form::short_description( $object_id, $product_short_description ); ?>
		<!-- Product Categories -->
		<?php WCVendors_Pro_Product_Form::categories( $object_id ); ?>
		<!-- Product Tags -->
		<?php WCVendors_Pro_Product_Form::tags( $object_id, true ); ?>
		<?php do_action( 'wcv_after_product_details', $object_id ); ?>
	</div>
	<div class="all-100">
		<?php do_action( 'wcv_before_product_media', $object_id ); ?>
		<!-- Media uploader -->
		<div class="wcv-product-media">
			<?php do_action( 'wcv_before_media', $object_id ); ?>
			<?php WCVendors_Pro_Form_helper::product_media_uploader( $object_id ); ?>
			<?php do_action( 'wcv_after_media', $object_id ); ?>
		</div>
		<?php do_action( 'wcv_after_product_media', $object_id ); ?>
	</div>
	<hr/>
	<div class="all-100">
		<?php do_action( 'wcv_before_product_type', $object_id ); ?>
		<!-- Product Type -->
		<div class="wcv-product-type">
			<?php WCVendors_Pro_Product_Form::product_type( $object_id ); ?>
		</div>
		<?php do_action( 'wcv_after_product_type', $object_id ); ?>
	</div>
	<div class="all-100">
		<div class="wcv-tabs top" data-prevent-url-change="true">
			<?php do_action( 'wcv_before_product_meta_tabs', $object_id ); ?>
			<?php WCVendors_Pro_Product_Form::product_meta_tabs(); ?>
			<?php do_action( 'wcv_before_general_tab', $object_id ); ?>
			<!-- General Product Options -->
			<div class="wcv-product-general tabs-content" id="general">
				<div class="hide_if_grouped">
					<!-- SKU  -->
					<?php WCVendors_Pro_Product_Form::sku( $object_id ); ?>
					<!-- Private listing  -->
					<?php WCVendors_Pro_Product_Form::private_listing( $object_id ); ?>
				</div>
				<div class="options_group show_if_external">
					<?php WCVendors_Pro_Product_Form::external_url( $object_id ); ?>
					<?php WCVendors_Pro_Product_Form::button_text( $object_id ); ?>
				</div>
				<div class="show_if_simple show_if_external">
					<!-- Price and Sale Price -->
					<?php WCVendors_Pro_Product_Form::prices( $object_id ); ?>
				</div>
				<div class="show_if_simple show_if_external show_if_variable">
					<!-- Tax -->
					<?php WCVendors_Pro_Product_Form::tax( $object_id ); ?>
				</div>
				<div class="show_if_downloadable" id="files_download">
					<!-- Downloadable files -->
					<?php WCVendors_Pro_Product_Form::download_files( $object_id ); ?>
					<!-- Download Limit -->
					<?php WCVendors_Pro_Product_Form::download_limit( $object_id ); ?>
					<!-- Download Expiry -->
					<?php WCVendors_Pro_Product_Form::download_expiry( $object_id ); ?>
					<!-- Download Type -->
					<?php WCVendors_Pro_Product_Form::download_type( $object_id ); ?>
				</div>
				<?php do_action( 'wcv_product_options_general_product_data', $object_id ); ?>
			</div>
			<?php do_action( 'wcv_after_general_tab', $object_id ); ?>
			<?php do_action( 'wcv_before_inventory_tab', $object_id ); ?>
			<!-- Inventory -->
			<div class="wcv-product-inventory inventory_product_data tabs-content" id="inventory">
				<?php WCVendors_Pro_Product_Form::manage_stock( $object_id ); ?>
				<?php do_action( 'wcv_product_options_stock', $object_id ); ?>
				<div class="stock_fields show_if_simple show_if_variable">
					<?php WCVendors_Pro_Product_Form::stock_qty( $object_id ); ?>
					<?php WCVendors_Pro_Product_Form::backorders( $object_id ); ?>
					<?php WCVendors_Pro_Product_Form::low_stock_threshold( $object_id ); ?>
				</div>
				<?php WCVendors_Pro_Product_Form::stock_status( $object_id ); ?>
				<div class="options_group show_if_simple show_if_variable">
					<?php WCVendors_Pro_Product_Form::sold_individually( $object_id ); ?>
				</div>
				<?php do_action( 'wcv_product_options_sold_individually', $object_id ); ?>
				<?php do_action( 'wcv_product_options_inventory_product_data', $object_id ); ?>
			</div>
			<?php do_action( 'wcv_after_inventory_tab', $object_id ); ?>
			<?php do_action( 'wcv_before_shipping_tab', $object_id ); ?>
			<!-- Shipping  -->
			<div class="wcv-product-shipping shipping_product_data tabs-content" id="shipping">
				<div class="hide_if_grouped hide_if_external">
					<!-- Shipping rates  -->
					<?php WCVendors_Pro_Product_Form::shipping_rates( $object_id ); ?>
					<!-- weight  -->
					<?php WCVendors_Pro_Product_Form::weight( $object_id ); ?>
					<!-- Dimensions -->
					<?php WCVendors_Pro_Product_Form::dimensions( $object_id ); ?>
					<?php do_action( 'wcv_product_options_dimensions', $object_id ); ?>
					<!-- shipping class -->
					<?php WCVendors_Pro_Product_Form::shipping_class( $object_id ); ?>
					<?php do_action( 'wcv_product_options_shipping', $object_id ); ?>
					<?php do_action( 'wcv_product_options_shipping_data_panel', $object_id ); ?>
				</div>
			</div>
			<?php do_action( 'wcv_after_shipping_tab', $object_id ); ?>
			<?php do_action( 'wcv_before_linked_tab', $object_id ); ?>
			<!-- Upsells and grouping -->
			<div class="wcv-product-upsells tabs-content" id="linked_product">
				<div class="show_if_grouped hide_if_external">
					<?php WCVendors_Pro_Product_Form::grouped_products( $object_id, $product ); ?>
				</div>
				<?php WCVendors_Pro_Product_Form::up_sells( $object_id ); ?>
				<div class="hide_if_grouped hide_if_external">
					<?php WCVendors_Pro_Product_Form::crosssells( $object_id ); ?>
				</div>
				<?php do_action( 'wcv_product_options_upsells_product_data' ); ?>
			</div>
			<?php do_action( 'wcv_after_linked_tab', $object_id ); ?>
			<!-- Attributes -->
			<?php do_action( 'wcv_before_attributes_tab', $object_id ); ?>
			<div class="wcv_product_attributes tabs-content" id="attributes">
				<?php WCVendors_Pro_Product_Form::product_attributes( $object_id ); ?>
				<?php do_action( 'wcv_product_options_attributes_product_data', $object_id ); ?>
			</div>
			<?php do_action( 'wcv_after_attributes_tab', $object_id ); ?>
			<!-- Variations -->
			<?php do_action( 'wcv_before_variations_tab', $object_id ); ?>
			<div class="wcv_product_variations tabs-content" id="variations">
				<?php WCVendors_Pro_Product_Form::product_variations( $object_id ); ?>
				<?php do_action( 'wcv_product_options_variations_product_data', $object_id ); ?>
			</div>
			<?php do_action( 'wcv_after_variations_tab', $object_id ); ?>
			<!-- Product SEO -->
			<?php do_action( 'wcv_before_seo_tab', $object_id ); ?>
			<div class="wcv_product_seo tabs-content" id="seo">
				<?php WCVendors_Pro_Product_Form::product_seo( $object_id ); ?>
				<?php do_action( 'wcv_product_seo_data' ); ?>
			</div>
			<?php do_action( 'wcv-after_seo_tab', $object_id ); ?>
			<?php WCVendors_Pro_Product_Form::form_data( $object_id, $post_status ); ?>
			<?php WCVendors_Pro_Product_Form::save_button( $title ); ?>
			<?php WCVendors_Pro_Product_Form::draft_button( __( 'Save Draft', 'wcvendors-pro' ) ); ?>
			<?php do_action( 'wcv_after_product_meta_tabs', $object_id ); ?>
		</div>
	</div>
</form>
<?php do_action( 'wcvendors_after_product_form' ); ?>

Need help?

If you have a question or run into any issues, we are here to help.

Was this article helpful?

Related Articles

Need Support?

Can't find the answer you're looking for?
Contact Support
Complete Your Purchase