{"id":160850,"date":"2022-08-05T04:37:51","date_gmt":"2022-08-05T04:37:51","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/order-dropdown-contact-form-7-for-woocommerce\/"},"modified":"2026-06-29T09:50:17","modified_gmt":"2026-06-29T09:50:17","slug":"order-dropdown-contact-form-7-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/en-gb.wordpress.org\/plugins\/order-dropdown-contact-form-7-for-woocommerce\/","author":20419894,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0","stable_tag":"trunk","tested":"7.0","requires":"5.5","requires_php":"7.0","requires_plugins":null,"header_name":"Order Dropdown Contact Form 7 For Woocommerce","header_author":"","header_description":"WooCommerce Order Dropdown List.","assets_banners_color":"7f7fb1","last_updated":"2026-06-29 09:50:17","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":4,"author_block_rating":0,"active_installs":10,"downloads":1425,"num_ratings":2,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"1.0":"<p>Initial release. Install to add a live WooCommerce order dropdown field to any Contact Form 7 form \u2014 perfect for support, returns, and order enquiry forms.<\/p>"},"ratings":{"1":0,"2":0,"3":1,"4":0,"5":1},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3475261,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3475261,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3475261,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3475261,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":[],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":2766715,"resolution":"1","location":"assets","locale":"","width":1892,"height":853},"screenshot-2.png":{"filename":"screenshot-2.png","revision":2766715,"resolution":"2","location":"assets","locale":"","width":1894,"height":765},"screenshot-3.png":{"filename":"screenshot-3.png","revision":2766715,"resolution":"3","location":"assets","locale":"","width":1915,"height":891},"screenshot-4.png":{"filename":"screenshot-4.png","revision":2766715,"resolution":"4","location":"assets","locale":"","width":1367,"height":856}},"screenshots":{"1":"CF7 form editor \u2014 \"woocommerce_order\" tag button highlighted in the form toolbar","2":"CF7 form template \u2014 generated [woocommerce_order] shortcode tag shown in the form body","3":"Form-tag Generator modal \u2014 required field, name, ID, class, and order status fields with Insert Tag button","4":"Front-end contact form \u2014 WooCommerce order dropdown listing orders by number, status, and date"}},"plugin_section":[],"plugin_tags":[269426,269427,170482,269424,269425],"plugin_category":[],"plugin_contributors":[256981],"plugin_business_model":[],"class_list":["post-160850","plugin","type-plugin","status-publish","hentry","plugin_tags-cf7-woocommerce-integration","plugin_tags-contact-form-7-order-list","plugin_tags-contact-form-7-woocommerce","plugin_tags-order-dropdown-cf7","plugin_tags-woocommerce-order-field","plugin_contributors-howdytheme","plugin_committers-howdytheme"],"banners":{"banner":"https:\/\/ps.w.org\/order-dropdown-contact-form-7-for-woocommerce\/assets\/banner-772x250.png?rev=3475261","banner_2x":"https:\/\/ps.w.org\/order-dropdown-contact-form-7-for-woocommerce\/assets\/banner-1544x500.png?rev=3475261","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/order-dropdown-contact-form-7-for-woocommerce\/assets\/icon-128x128.png?rev=3475261","icon_2x":"https:\/\/ps.w.org\/order-dropdown-contact-form-7-for-woocommerce\/assets\/icon-256x256.png?rev=3475261","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/order-dropdown-contact-form-7-for-woocommerce\/assets\/screenshot-1.png?rev=2766715","caption":"CF7 form editor \u2014 \"woocommerce_order\" tag button highlighted in the form toolbar"},{"src":"https:\/\/ps.w.org\/order-dropdown-contact-form-7-for-woocommerce\/assets\/screenshot-2.png?rev=2766715","caption":"CF7 form template \u2014 generated [woocommerce_order] shortcode tag shown in the form body"},{"src":"https:\/\/ps.w.org\/order-dropdown-contact-form-7-for-woocommerce\/assets\/screenshot-3.png?rev=2766715","caption":"Form-tag Generator modal \u2014 required field, name, ID, class, and order status fields with Insert Tag button"},{"src":"https:\/\/ps.w.org\/order-dropdown-contact-form-7-for-woocommerce\/assets\/screenshot-4.png?rev=2766715","caption":"Front-end contact form \u2014 WooCommerce order dropdown listing orders by number, status, and date"}],"raw_content":"<!--section=description-->\n<p><strong>Order Dropdown Contact Form 7 For WooCommerce<\/strong> adds a powerful new form field type to Contact Form 7 that renders a dynamic dropdown list of WooCommerce orders. Customers can select an order directly from the form \u2014 making it ideal for support requests, return and refund enquiries, order follow-ups, and any form where a customer needs to reference a specific WooCommerce order.<\/p>\n\n<p>The plugin registers a custom <code>[woocommerce_order]<\/code> form tag and adds a visual tag generator to the Contact Form 7 editor, so you can build and insert the field without touching any code.<\/p>\n\n<blockquote>\n  <p><strong>Requires both Contact Form 7 and WooCommerce<\/strong> to be installed and activated.<\/p>\n<\/blockquote>\n\n<p><a href=\"https:\/\/topsmodule.com\/how-to-create-order-dropdown-woocommerce-for-contact-form-7\/\">\ud83d\udcc4 Documentation<\/a> | <a href=\"https:\/\/topsmodule.com\/task\/order-dropdown-contact-form-7-for-woocommerce\/\">\ud83d\udd34 Live Demo<\/a><\/p>\n\n\n\n<h4>How It Works<\/h4>\n\n<p>Once installed, a new <strong>woocommerce_order<\/strong> field type appears in the Contact Form 7 tag generator. Insert the tag into any CF7 form and the field renders as a <code>&lt;select&gt;<\/code> dropdown on the front end. Each option displays the order ID, current order status, and the order creation date \u2014 giving customers enough context to identify their order at a glance.<\/p>\n\n<p>Example tag:\n    [woocommerce_order woocommerce_order-968 status:wc-processing|wc-on-hold]<\/p>\n\n<p>The selected order value is then available as a mail tag, so it gets included in the notification email sent to you when the form is submitted.<\/p>\n\n\n\n<h4>Key Features<\/h4>\n\n<p><strong>WooCommerce Order Dropdown Field<\/strong>\n* Adds a new <code>[woocommerce_order]<\/code> form tag to Contact Form 7\n* Renders a fully functional <code>&lt;select&gt;<\/code> dropdown populated with live WooCommerce orders\n* Each dropdown option displays the order number, status, and creation date in the format: <code>#123 (Status: processing) - (Date: Jan 15, 2024)<\/code> \u2014 making it easy for customers to identify the right order<\/p>\n\n<p><strong>Filter Orders by Status<\/strong>\n* Control exactly which orders appear in the dropdown using the <code>status:<\/code> option\n* Supports all standard WooCommerce order statuses: <code>wc-pending<\/code>, <code>wc-processing<\/code>, <code>wc-on-hold<\/code>, <code>wc-completed<\/code>, <code>wc-cancelled<\/code>, <code>wc-refunded<\/code>, <code>wc-failed<\/code>\n* Filter by multiple statuses at once using pipe <code>|<\/code> separators \u2014 for example: <code>status:wc-processing|wc-on-hold|wc-completed<\/code>\n* Leave the status option empty to show orders of all statuses<\/p>\n\n<p><strong>Visual Tag Generator in CF7 Editor<\/strong>\n* A dedicated tag generator panel is added directly inside the Contact Form 7 form editor \u2014 no manual shortcode writing needed\n* Configure the field name, HTML ID, CSS class, and order status filter all from a clean UI\n* Generated tag is previewed live and inserted into the form with one click\n* Includes a mail tag reference tip so you know exactly how to include the selected value in your notification emails<\/p>\n\n<p><strong>Required Field Support<\/strong>\n* Mark the order dropdown as a required field by checking the \"This is a required field\" option in the tag generator (adds the <code>*<\/code> suffix to the tag)\n* Full CF7 validation integration \u2014 shows CF7's standard validation error message if the required field is left empty on submission\n* Proper <code>aria-required<\/code> and <code>aria-invalid<\/code> accessibility attributes are applied automatically<\/p>\n\n<p><strong>Custom ID &amp; Class<\/strong>\n* Set a custom HTML <code>id<\/code> attribute on the dropdown for JavaScript targeting or CSS anchor styling\n* Add one or more custom CSS <code>class<\/code> names to the dropdown for full styling control<\/p>\n\n<p><strong>Mail Tag Integration<\/strong>\n* The selected order value is automatically available as a CF7 mail tag\n* Insert the mail tag into the CF7 Mail tab to include the selected order in form notification emails sent to admins or customers<\/p>\n\n<p><strong>Fully Responsive<\/strong>\n* The order dropdown is responsive and adapts gracefully on mobile and small screens\n* Font size is automatically adjusted on screens under 767px for comfortable readability on smartphones and tablets<\/p>\n\n<p><strong>Clean &amp; Secure<\/strong>\n* All submitted data is sanitized using <code>sanitize_text_field<\/code> before processing\n* Lightweight \u2014 only a minimal CSS file is enqueued on the front end; no unnecessary JavaScript dependencies\n* Follows WordPress and Contact Form 7 coding standards throughout<\/p>\n\n\n\n<h4>Example Use Cases<\/h4>\n\n<ul>\n<li><strong>Customer Support Forms<\/strong> \u2014 Let customers select the specific order they are asking about in a support or help desk form<\/li>\n<li><strong>Return &amp; Refund Requests<\/strong> \u2014 Add an order dropdown to your returns form so customers identify the order they wish to return<\/li>\n<li><strong>Order Follow-Up Forms<\/strong> \u2014 Allow customers to check in on the status of a specific order by selecting it from the form<\/li>\n<li><strong>Complaint &amp; Feedback Forms<\/strong> \u2014 Reference a specific WooCommerce order as part of a complaint or feedback submission<\/li>\n<li><strong>Cancellation Request Forms<\/strong> \u2014 Let customers select a pending or processing order they want to cancel<\/li>\n<\/ul>\n\n\n\n<h4>Order Status Reference<\/h4>\n\n<p>When using the <code>status:<\/code> option, use the following WooCommerce status slugs:<\/p>\n\n<ul>\n<li><code>wc-pending<\/code> \u2014 Payment pending<\/li>\n<li><code>wc-processing<\/code> \u2014 Payment received, order being processed<\/li>\n<li><code>wc-on-hold<\/code> \u2014 Awaiting payment confirmation<\/li>\n<li><code>wc-completed<\/code> \u2014 Order fulfilled and complete<\/li>\n<li><code>wc-cancelled<\/code> \u2014 Order cancelled<\/li>\n<li><code>wc-refunded<\/code> \u2014 Order refunded<\/li>\n<li><code>wc-failed<\/code> \u2014 Payment failed or declined<\/li>\n<\/ul>\n\n<p>Separate multiple statuses with a pipe character: <code>status:wc-processing|wc-on-hold<\/code><\/p>\n\n<!--section=installation-->\n<p><strong>From the WordPress Plugin Directory:<\/strong><\/p>\n\n<ol>\n<li>Make sure <strong>Contact Form 7<\/strong> and <strong>WooCommerce<\/strong> are both installed and activated.<\/li>\n<li>In your WordPress dashboard, go to <strong>Plugins &gt; Add New<\/strong>.<\/li>\n<li>Search for <strong>\"Order Dropdown Contact Form 7 For WooCommerce\"<\/strong> and click <strong>Install Now<\/strong>.<\/li>\n<li>Click <strong>Activate<\/strong> once installation is complete.<\/li>\n<li>Open any Contact Form 7 form \u2014 click the new <strong>woocommerce_order<\/strong> button in the tag generator toolbar.<\/li>\n<li>Configure your field name, ID, class, and order status filter, then click <strong>Insert Tag<\/strong>.<\/li>\n<li>Save the form and test it on the front end \u2014 the dropdown will appear with your live WooCommerce orders.<\/li>\n<\/ol>\n\n<p><strong>Manual Upload:<\/strong><\/p>\n\n<ol>\n<li>Download the plugin ZIP file.<\/li>\n<li>In your WordPress dashboard, go to <strong>Plugins &gt; Add New &gt; Upload Plugin<\/strong>.<\/li>\n<li>Upload the ZIP and click <strong>Install Now<\/strong>, then <strong>Activate<\/strong>.<\/li>\n<li>Follow steps 5\u20137 above.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20plugin%20require%20contact%20form%207%20and%20woocommerce%3F\"><h3>Does this plugin require Contact Form 7 and WooCommerce?<\/h3><\/dt>\n<dd><p>Yes. Both <strong>Contact Form 7<\/strong> and <strong>WooCommerce<\/strong> must be installed and activated. The plugin registers a custom CF7 form tag and queries WooCommerce orders \u2014 it cannot function without either plugin.<\/p><\/dd>\n<dt id=\"where%20do%20i%20find%20the%20new%20order%20dropdown%20field%20in%20cf7%3F\"><h3>Where do I find the new order dropdown field in CF7?<\/h3><\/dt>\n<dd><p>After activating the plugin, open any Contact Form 7 form in your WordPress admin. You will see a new <strong>woocommerce_order<\/strong> button in the tag generator toolbar above the form editor. Click it to open the tag generator panel.<\/p><\/dd>\n<dt id=\"how%20do%20i%20filter%20the%20dropdown%20to%20show%20only%20certain%20order%20statuses%3F\"><h3>How do I filter the dropdown to show only certain order statuses?<\/h3><\/dt>\n<dd><p>In the tag generator, enter the desired WooCommerce status slugs in the <strong>Order Status<\/strong> field, separated by the pipe character <code>|<\/code>. For example: <code>wc-processing|wc-on-hold<\/code>. You can also add the <code>status:<\/code> option manually in the form tag. Leave the field empty to show all order statuses.<\/p><\/dd>\n<dt id=\"can%20i%20make%20the%20order%20dropdown%20a%20required%20field%3F\"><h3>Can I make the order dropdown a required field?<\/h3><\/dt>\n<dd><p>Yes. In the tag generator panel, check the <strong>\"This is a required field\"<\/strong> checkbox. This appends <code>*<\/code> to the tag type, and CF7 will show a validation error if the visitor submits the form without selecting an order.<\/p><\/dd>\n<dt id=\"how%20does%20the%20selected%20order%20appear%20in%20the%20notification%20email%3F\"><h3>How does the selected order appear in the notification email?<\/h3><\/dt>\n<dd><p>The plugin supports CF7 mail tags. After inserting the tag, go to the <strong>Mail<\/strong> tab of the CF7 form editor and insert the corresponding mail tag (shown at the bottom of the tag generator panel) into your email body. The selected order number, status, and date will appear in the email when the form is submitted.<\/p><\/dd>\n<dt id=\"can%20i%20add%20custom%20css%20to%20style%20the%20order%20dropdown%3F\"><h3>Can I add custom CSS to style the order dropdown?<\/h3><\/dt>\n<dd><p>Yes. Use the <strong>Class<\/strong> field in the tag generator to assign one or more custom CSS classes to the dropdown, then target those classes in your theme's stylesheet or the WordPress Customizer's Additional CSS field.<\/p><\/dd>\n<dt id=\"is%20the%20plugin%20mobile-friendly%3F\"><h3>Is the plugin mobile-friendly?<\/h3><\/dt>\n<dd><p>Yes. A responsive CSS rule is included that adjusts the dropdown font size on screens narrower than 767px, ensuring comfortable usability on mobile devices.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0<\/h4>\n\n<ul>\n<li>Initial release \u2014 Adds a [woocommerce_order] form tag to Contact Form 7 that renders a filterable WooCommerce order dropdown, with tag generator UI, required field validation, custom ID\/class support, and mail tag integration.<\/li>\n<\/ul>","raw_excerpt":"Add a WooCommerce order dropdown field to any Contact Form 7 form. Let customers select their order by status and date \u2014 no coding required.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/en-gb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/160850","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/en-gb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/en-gb.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/en-gb.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=160850"}],"author":[{"embeddable":true,"href":"https:\/\/en-gb.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/howdytheme"}],"wp:attachment":[{"href":"https:\/\/en-gb.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=160850"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/en-gb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=160850"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/en-gb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=160850"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/en-gb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=160850"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/en-gb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=160850"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/en-gb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=160850"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}