{"id":404219,"date":"2026-11-13T16:23:22","date_gmt":"2026-11-13T16:23:22","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/hamrah-product-suggestions-gift-boxes\/"},"modified":"2026-11-13T16:23:09","modified_gmt":"2026-11-13T16:23:09","slug":"hamrah","status":"publish","type":"plugin","link":"https:\/\/fa.wordpress.org\/plugins\/hamrah\/","author":23534883,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.3","stable_tag":"1.0.3","tested":"7.1.4","requires":"6.4","requires_php":"7.4","requires_plugins":null,"header_name":"Hamrah \u2013 Product Suggestions & Gift Boxes","header_author":"Hamidreza Moghaddam","header_description":"Suggest companion products on the product page that customers can pick one by one (or sell them as a required set), with per-item discounts, plus gift-box suggestions matched by size or category and a gift message.","last_updated":"2026-11-13 16:23:09","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/hamrah\/","header_author_uri":"https:\/\/profiles.wordpress.org\/mrhamidreza\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":55,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.3":{"tag":"1.0.3","author":"mrhamidreza","date":"2026-11-13 16:23:09","revision":3800803}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3800803,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3800803,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3800803,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500-rtl.png":{"filename":"banner-1544x500-rtl.png","revision":3800803,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3800803,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250-rtl.png":{"filename":"banner-772x250-rtl.png","revision":3800803,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3800803,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.3"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Suggestions and gift box on the product page.","2":"The Suggestions tab in the product editor."}},"plugin_section":[],"plugin_tags":[14503,31086,207261,1311,286],"plugin_category":[45],"plugin_contributors":[273895],"plugin_business_model":[],"class_list":["post-404219","plugin","type-plugin","status-publish","hentry","plugin_tags-bundle","plugin_tags-frequently-bought-together","plugin_tags-gift-box","plugin_tags-upsell","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-mrhamidreza","plugin_committers-mrhamidreza"],"banners":{"banner":"https:\/\/ps.w.org\/hamrah\/assets\/banner-772x250-rtl.png?rev=3800803","banner_2x":"https:\/\/ps.w.org\/hamrah\/assets\/banner-1544x500-rtl.png?rev=3800803","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/hamrah\/assets\/icon.svg?rev=3800803","icon":"https:\/\/ps.w.org\/hamrah\/assets\/icon.svg?rev=3800803","icon_2x":false,"generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Hamrah adds a \"complete your order\" block to the WooCommerce product page.<\/p>\n\n<p><strong>Suggestions you control per product<\/strong><\/p>\n\n<ul>\n<li>Pick any simple product or single variation as a suggestion, with its own quantity and an optional percent or fixed discount.<\/li>\n<li>Choose how they are sold: <strong>optional<\/strong> (the customer ticks only the items they want) or <strong>required set<\/strong> (everything is added together).<\/li>\n<li>Pre-select items you recommend most.<\/li>\n<li>A running total shows the product plus the selected items before adding to cart.<\/li>\n<\/ul>\n\n<p><strong>Correct cart, every time<\/strong><\/p>\n\n<ul>\n<li>Each suggestion is added as its own cart line, so prices, stock, coupons and shipping rules keep working normally.<\/li>\n<li>Discounts apply only while the main product is in the cart.<\/li>\n<li>Items of a required set follow the main product's quantity and are removed together with it.<\/li>\n<\/ul>\n\n<p><strong>Gift boxes<\/strong><\/p>\n\n<ul>\n<li>Mark any product as a gift box and enter its inner size.<\/li>\n<li>Boxes are offered when the product fits inside (any orientation, with a packing margin you set), when the box is assigned to the product's category, or when you choose boxes on the product.<\/li>\n<li>The customer can add a gift message and ask for no prices in the package. Both show in the cart, the order, the emails and as an order note.<\/li>\n<\/ul>\n\n<p>Hamrah has no external services, no tracking and no upsell screens. It works with HPOS and the cart and checkout blocks.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin and activate it. WooCommerce must be active.<\/li>\n<li>Go to WooCommerce \u2192 Settings \u2192 Products \u2192 Suggestions &amp; gift boxes to set the defaults and turn on gift boxes.<\/li>\n<li>Edit a product and open the \"Suggestions\" tab to add suggested products.<\/li>\n<li>To offer gift boxes, tick \"Gift box\" in the Shipping tab of the box product, then assign boxes to categories or enter product dimensions.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"can%20a%20variable%20product%20be%20suggested%3F\"><h3>Can a variable product be suggested?<\/h3><\/dt>\n<dd><p>Suggest a specific variation. A variable product itself cannot be added without a choice of options.<\/p><\/dd>\n<dt id=\"what%20happens%20if%20the%20customer%20removes%20the%20main%20product%3F\"><h3>What happens if the customer removes the main product?<\/h3><\/dt>\n<dd><p>Items of a required set and gift boxes are removed with it. Optional items stay in the cart at their normal price.<\/p><\/dd>\n<dt id=\"what%20if%20an%20item%20of%20a%20required%20set%20is%20out%20of%20stock%3F\"><h3>What if an item of a required set is out of stock?<\/h3><\/dt>\n<dd><p>The set cannot be added to the cart and the product page explains why.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20page%20caching%3F\"><h3>Does it work with page caching?<\/h3><\/dt>\n<dd><p>Yes. The block contains no user-specific data and needs no session-bound tokens.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>Fix: the running total now works in block themes (prices, currency and variations).<\/li>\n<li>The gift message box uses the theme font.<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Product page: keep the layout fix working in themes that force the add to cart form onto one row.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Product page: the block takes its own row in themes that lay out the add to cart form as a single row.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First release.<\/li>\n<\/ul>","raw_excerpt":"Suggest companion products customers can pick one by one or sell them as a set, with per-item discounts, plus gift boxes matched by size or category.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/404219","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=404219"}],"author":[{"embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/mrhamidreza"}],"wp:attachment":[{"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=404219"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=404219"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=404219"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=404219"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=404219"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/fa.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=404219"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}