{"id":78,"date":"2018-04-26T18:59:36","date_gmt":"2018-04-26T18:59:36","guid":{"rendered":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/?p=78"},"modified":"2025-02-21T12:56:17","modified_gmt":"2025-02-21T12:56:17","slug":"donation-form","status":"publish","type":"post","link":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/","title":{"rendered":"Donation Form and shortcode"},"content":{"rendered":"\n<p>You can add a donation form to any sidebar of your site using the widget <b>&#8220;YITH Donations for WooCommerce&#8221;<\/b>.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-30-14.55.07.png\" data-rel=\"lightbox-image-0\" data-rl_title=\"\" data-rl_caption=\"\" title=\"\"><img loading=\"lazy\" decoding=\"async\" width=\"788\" height=\"468\" src=\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-30-14.55.07.png\" alt=\"shortcode\" class=\"wp-image-406\" srcset=\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-30-14.55.07.png 788w, https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-30-14.55.07-300x178.png 300w, https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-30-14.55.07-768x456.png 768w\" sizes=\"auto, (max-width: 788px) 100vw, 788px\" \/><\/a><\/figure>\n\n\n\n<p>If you want to add the form to the page content, you can use the shortcode  <strong>[yith_wcds_donations]<\/strong>. Click on the dedicated button of your WordPress visual editor or enter it in textual mode.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Visual editor (automatically created)<\/h3>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/donations7.jpg\" data-rel=\"lightbox-image-1\" data-rl_title=\"\" data-rl_caption=\"\" title=\"\"><img loading=\"lazy\" decoding=\"async\" width=\"732\" height=\"296\" src=\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/donations7.jpg\" alt=\"donations7\" class=\"wp-image-80\" srcset=\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/donations7.jpg 732w, https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/donations7-300x121.jpg 300w\" sizes=\"auto, (max-width: 732px) 100vw, 732px\" \/><\/a><\/figure>\n\n\n\n<p>By clicking on this button, you can fill out the popup fields.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-29-19.38.35.png\" data-rel=\"lightbox-image-2\" data-rl_title=\"\" data-rl_caption=\"\" title=\"\"><img loading=\"lazy\" decoding=\"async\" width=\"840\" height=\"403\" src=\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-29-19.38.35.png\" alt=\"shortcode popup\" class=\"wp-image-390\" srcset=\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-29-19.38.35.png 840w, https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-29-19.38.35-300x144.png 300w, https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-29-19.38.35-768x368.png 768w\" sizes=\"auto, (max-width: 840px) 100vw, 840px\" \/><\/a><\/figure>\n\n\n\n<p>The according shortcode is created automatically.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Textual shortcode (manually created)<\/h3>\n\n\n\n<p>The shortcode attributes are the following:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><b>donation_amount<\/b>: enter pre-set amounts separated by a vertical bar ( | ). Leave empty if you want to let your users enter a custom amount.<\/li>\n\n\n\n<li><b>donation_amount_style<\/b>: choose the style of the pre-set amounts: it can be either label or radio.<\/li>\n\n\n\n<li><b>show_extra_desc<\/b>: set to &#8220;on&#8221; if you want to add an extra field to the donation form.<\/li>\n\n\n\n<li><b>extra_desc_label<\/b>: enter here the\u00a0title of the extra field.<\/li>\n<\/ul>\n\n\n\n<p>For example, if you build the shortcode like this:<\/p>\n\n\n\n<p><code>[yith_wcds_donations donation_amount=\"10|20|30\" donation_amount_style=\"radio\" show_extra_desc=\"on\" extra_desc_label=\"Tell us more about why you are donating, we are so grateful!\"]<\/code><\/p>\n\n\n\n<p>This is what it will look like on the Shop page:<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-30-14.50.37.png\" data-rel=\"lightbox-image-3\" data-rl_title=\"\" data-rl_caption=\"\" title=\"\"><img loading=\"lazy\" decoding=\"async\" width=\"707\" height=\"715\" src=\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-30-14.50.37.png\" alt=\"shortcode on page\" class=\"wp-image-402\" srcset=\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-30-14.50.37.png 707w, https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-30-14.50.37-297x300.png 297w\" sizes=\"auto, (max-width: 707px) 100vw, 707px\" \/><\/a><\/figure>\n\n\n\n<p>The plugin allows adding the form also into the detail page of one or more products. Read more about this\u00a0<a href=\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/premium-version-settings\/donation-per-product\/\">here<\/a>.<\/p>\n\n\n\n<p>If you want to customize the style of the button <b>&#8220;Add a Donation&#8221;,<\/b> please go to <a href=\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/button-settings\/\" target=\"_blank\" rel=\"noopener\">this page<\/a>.<\/p>\n\n\n\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>You can add a donation form to any sidebar of your site using the widget &#8220;YITH Donations for WooCommerce&#8221;. If you want to add the form to the page content, you can use the shortcode [yith_wcds_donations]. Click on the dedicated button of your WordPress visual editor or enter it in textual mode. Visual editor (automatically &hellip; <a href=\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/\" class=\"more-link\">Continue reading <span class=\"screen-reader-text\">Donation Form and shortcode<\/span><\/a><\/p>\n","protected":false},"author":4,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[6],"tags":[],"class_list":["post-78","post","type-post","status-publish","format-standard","hentry","category-settings"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v24.8.1 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>YITH Donations: Donation Form and shortcode<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"YITH Donations: Donation Form and shortcode\" \/>\n<meta property=\"og:description\" content=\"You can add a donation form to any sidebar of your site using the widget &#8220;YITH Donations for WooCommerce&#8221;. If you want to add the form to the page content, you can use the shortcode [yith_wcds_donations]. Click on the dedicated button of your WordPress visual editor or enter it in textual mode. Visual editor (automatically &hellip; Continue reading Donation Form and shortcode\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/\" \/>\n<meta property=\"og:site_name\" content=\"YITH Donations for WooCommerce\" \/>\n<meta property=\"article:published_time\" content=\"2018-04-26T18:59:36+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-02-21T12:56:17+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-30-14.55.07.png\" \/>\n\t<meta property=\"og:image:width\" content=\"788\" \/>\n\t<meta property=\"og:image:height\" content=\"468\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Alessio Torrisi\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Alessio Torrisi\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/\",\"url\":\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/\",\"name\":\"YITH Donations: Donation Form and shortcode\",\"isPartOf\":{\"@id\":\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-30-14.55.07.png\",\"datePublished\":\"2018-04-26T18:59:36+00:00\",\"dateModified\":\"2025-02-21T12:56:17+00:00\",\"author\":{\"@id\":\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/#\/schema\/person\/cb8b9dbb75e34f325cc8329424e6a6c5\"},\"breadcrumb\":{\"@id\":\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/#primaryimage\",\"url\":\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-30-14.55.07.png\",\"contentUrl\":\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-30-14.55.07.png\",\"width\":788,\"height\":468,\"caption\":\"shortcode\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Donation Form and shortcode\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/#website\",\"url\":\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/\",\"name\":\"YITH Donations for WooCommerce\",\"description\":\"Plugin documentation\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/#\/schema\/person\/cb8b9dbb75e34f325cc8329424e6a6c5\",\"name\":\"Alessio Torrisi\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/1dc305ade0adaba279202977d3352276?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/1dc305ade0adaba279202977d3352276?s=96&d=mm&r=g\",\"caption\":\"Alessio Torrisi\"},\"url\":\"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/author\/alessio\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"YITH Donations: Donation Form and shortcode","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/","og_locale":"en_US","og_type":"article","og_title":"YITH Donations: Donation Form and shortcode","og_description":"You can add a donation form to any sidebar of your site using the widget &#8220;YITH Donations for WooCommerce&#8221;. If you want to add the form to the page content, you can use the shortcode [yith_wcds_donations]. Click on the dedicated button of your WordPress visual editor or enter it in textual mode. Visual editor (automatically &hellip; Continue reading Donation Form and shortcode","og_url":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/","og_site_name":"YITH Donations for WooCommerce","article_published_time":"2018-04-26T18:59:36+00:00","article_modified_time":"2025-02-21T12:56:17+00:00","og_image":[{"width":788,"height":468,"url":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-30-14.55.07.png","type":"image\/png"}],"author":"Alessio Torrisi","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Alessio Torrisi","Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/","url":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/","name":"YITH Donations: Donation Form and shortcode","isPartOf":{"@id":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/#website"},"primaryImageOfPage":{"@id":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/#primaryimage"},"image":{"@id":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/#primaryimage"},"thumbnailUrl":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-30-14.55.07.png","datePublished":"2018-04-26T18:59:36+00:00","dateModified":"2025-02-21T12:56:17+00:00","author":{"@id":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/#\/schema\/person\/cb8b9dbb75e34f325cc8329424e6a6c5"},"breadcrumb":{"@id":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/#primaryimage","url":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-30-14.55.07.png","contentUrl":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-content\/uploads\/sites\/102\/2018\/04\/Screenshot-2021-03-30-14.55.07.png","width":788,"height":468,"caption":"shortcode"},{"@type":"BreadcrumbList","@id":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/settings\/donation-form\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/"},{"@type":"ListItem","position":2,"name":"Donation Form and shortcode"}]},{"@type":"WebSite","@id":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/#website","url":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/","name":"YITH Donations for WooCommerce","description":"Plugin documentation","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/#\/schema\/person\/cb8b9dbb75e34f325cc8329424e6a6c5","name":"Alessio Torrisi","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/1dc305ade0adaba279202977d3352276?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/1dc305ade0adaba279202977d3352276?s=96&d=mm&r=g","caption":"Alessio Torrisi"},"url":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/author\/alessio\/"}]}},"_links":{"self":[{"href":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-json\/wp\/v2\/posts\/78","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-json\/wp\/v2\/comments?post=78"}],"version-history":[{"count":18,"href":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-json\/wp\/v2\/posts\/78\/revisions"}],"predecessor-version":[{"id":537,"href":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-json\/wp\/v2\/posts\/78\/revisions\/537"}],"wp:attachment":[{"href":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-json\/wp\/v2\/media?parent=78"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-json\/wp\/v2\/categories?post=78"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.yithemes.com\/yith-donations-for-woocommerce\/wp-json\/wp\/v2\/tags?post=78"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}