Premium: the "Insert template" menu is no longer cut off, and the shop's email about a proof answer can say "approved" or "rejected" in its subject.<\/p>","1.9.0":"
Premium: customers can mark up PDF proofs too, page by page, and the orders list shows where each order's proofs stand.<\/p>","1.8.0":"
Fixes a fatal error 1.7.3 could cause on some sites. Premium: withdraw a proof without deleting it, and every message sent by hand kept on the order.<\/p>","1.7.3":"
Coming from the CodeCanyon plugins in another language: your old translation is used again for the texts that did not change.<\/p>","1.7.2":"
Premium: five more lines of the customer's proof screen can be changed on the Texts tab.<\/p>","1.7.1":"
Premium: choose when the emails about proofs go out, and which tab the order's box opens on. Nothing changes until you do.<\/p>","1.7.0":"
Premium: customers can draw their corrections on an image proof. Off until you switch it on in Proofs \/ File approval, or on a single file.<\/p>","1.6.5":"
Premium: hooks for developers on the customer's proof screen. Theme copies of premium\/proofs.php need updating to use them.<\/p>","1.6.4":"
The plugin's homepage is now its page on vanquishplugins.com. Nothing else changes.<\/p>","1.6.3":"
Premium: proofs can be started from other plugins' screens, such as "Send a proof" in Vanquish Upload Files. Nothing changes on update.<\/p>","1.6.2":"
Premium: a product file can be kept to the emails, with a switch of its own. A download link to such a file in an email now opens.<\/p>","1.6.1":"
The plugin's icon has new colours. Nothing else changes.<\/p>","1.6.0":"
The settings screen has been redrawn, with a save bar and a Texts tab you can search, one language at a time. Every setting keeps its value.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":3},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3757196,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3757196,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3757217,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3757217,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{"blueprint.json":{"filename":"blueprint.json","revision":3766378,"resolution":false,"location":"assets","locale":"","contents":"{\"$schema\":\"https:\\\/\\\/playground.wordpress.net\\\/blueprint-schema.json\",\"landingPage\":\"\\\/wp-admin\\\/admin.php?page=wc-orders\",\"preferredVersions\":{\"php\":\"8.2\",\"wp\":\"latest\"},\"phpExtensionBundles\":[\"kitchen-sink\"],\"features\":{\"networking\":true},\"steps\":[{\"step\":\"login\",\"username\":\"admin\",\"password\":\"password\"},{\"step\":\"installPlugin\",\"pluginData\":{\"resource\":\"wordpress.org\\\/plugins\",\"slug\":\"woocommerce\"},\"options\":{\"activate\":true}},{\"step\":\"installPlugin\",\"pluginData\":{\"resource\":\"wordpress.org\\\/plugins\",\"slug\":\"vanquish-attach-me-for-woocommerce\"},\"options\":{\"activate\":true}},{\"step\":\"installTheme\",\"themeData\":{\"resource\":\"wordpress.org\\\/themes\",\"slug\":\"emoza-woocommerce\"},\"options\":{\"activate\":true}},{\"step\":\"runPHP\",\"code\":\" Orders shows the same files as the buyer sees them.\\n *\\n * Every attachment goes through the plugin's own services -- Storage::adopt_for()\\n * for the file, OrderAttachments and ProductAttachments for the record -- rather\\n * than being written into meta by hand. The demo data then passes the same\\n * sanitising and lands in the same protected folders as a real upload, and if\\n * the storage format ever changes the seed follows it instead of quietly\\n * producing records the plugin no longer reads.\\n *\\n * Landing on \\\/wp-admin\\\/admin.php?page=wc-orders assumes HPOS. WooCommerce makes\\n * it the default on new installs and Playground always installs the latest, so\\n * that route exists. The option is deliberately not toggled here: the data stores\\n * are chosen when WooCommerce boots, before this script runs, and switching mid-\\n * request would create the orders in one store and list them from the other.\\n *\\n * Closures, not named functions: PHP binds a top-level function declaration when\\n * the file is compiled, so a guard that returns early does not stop it being\\n * declared -- and this file must be safe to run twice.\\n *\\n * Idempotent: guarded by the vanam_demo_seeded option.\\n *\\\/\\n\\nrequire_once '\\\/wordpress\\\/wp-load.php';\\n\\nif ( get_option( 'vanam_demo_seeded' ) ) {\\n\\treturn;\\n}\\n\\nuse Vanquish\\\\AttachMe\\\\Com\\\\Attachment;\\nuse Vanquish\\\\AttachMe\\\\Com\\\\OrderAttachments;\\nuse Vanquish\\\\AttachMe\\\\Com\\\\ProductAttachments;\\nuse Vanquish\\\\AttachMe\\\\Com\\\\Settings;\\nuse Vanquish\\\\AttachMe\\\\Com\\\\Storage;\\n\\n\\\/* ---------------------------------------------------------------------------\\n * 1. Store scaffolding\\n * ------------------------------------------------------------------------ *\\\/\\n\\nupdate_option( 'blogname', 'Vanquish Attach Me for WooCommerce' );\\n\\nif ( class_exists( 'WC_Install' ) ) {\\n\\tWC_Install::create_pages();\\n}\\n\\n\\\/* Recent WooCommerce hides a new store behind a \\\"coming soon\\\" page, which would\\n * put a splash screen between the visitor and the shop. *\\\/\\nupdate_option( 'woocommerce_coming_soon', 'no' );\\n\\nupdate_option( 'woocommerce_store_address', 'Via Roma 1' );\\nupdate_option( 'woocommerce_store_city', 'Pisa' );\\nupdate_option( 'woocommerce_default_country', 'IT:PI' );\\nupdate_option( 'woocommerce_store_postcode', '56100' );\\nupdate_option( 'woocommerce_currency', 'EUR' );\\n\\n\\\/* Tidy the front-end navigation: drop the default Sample Page and build a real\\n * menu, which also removes the theme's automatic \\\"Home\\\" fallback entry. *\\\/\\n$vanam_sample = get_page_by_path( 'sample-page' );\\nif ( $vanam_sample ) {\\n\\twp_delete_post( $vanam_sample->ID, true );\\n}\\n\\nif ( function_exists( 'wc_get_page_id' ) && ! wp_get_nav_menu_object( 'vanam-demo-menu' ) ) {\\n\\t$vanam_menu_id = wp_create_nav_menu( 'vanam-demo-menu' );\\n\\n\\tforeach ( array(\\n\\t\\t'Shop' => wc_get_page_id( 'shop' ),\\n\\t\\t'Cart' => wc_get_page_id( 'cart' ),\\n\\t\\t'Checkout' => wc_get_page_id( 'checkout' ),\\n\\t\\t'My account' => wc_get_page_id( 'myaccount' ),\\n\\t) as $vanam_label => $vanam_page_id ) {\\n\\t\\tif ( $vanam_page_id && $vanam_page_id > 0 ) {\\n\\t\\t\\twp_update_nav_menu_item(\\n\\t\\t\\t\\t$vanam_menu_id,\\n\\t\\t\\t\\t0,\\n\\t\\t\\t\\tarray(\\n\\t\\t\\t\\t\\t'menu-item-title' => $vanam_label,\\n\\t\\t\\t\\t\\t'menu-item-object' => 'page',\\n\\t\\t\\t\\t\\t'menu-item-object-id' => $vanam_page_id,\\n\\t\\t\\t\\t\\t'menu-item-type' => 'post_type',\\n\\t\\t\\t\\t\\t'menu-item-status' => 'publish',\\n\\t\\t\\t\\t)\\n\\t\\t\\t);\\n\\t\\t}\\n\\t}\\n\\n\\t$vanam_locations = get_theme_mod( 'nav_menu_locations' );\\n\\tif ( ! is_array( $vanam_locations ) ) {\\n\\t\\t$vanam_locations = array();\\n\\t}\\n\\tforeach ( array_keys( (array) get_registered_nav_menus() ) as $vanam_location ) {\\n\\t\\t$vanam_locations[ $vanam_location ] = $vanam_menu_id;\\n\\t}\\n\\tset_theme_mod( 'nav_menu_locations', $vanam_locations );\\n}\\n\\n\\\/* Payments and shipping, so the demo checkout can actually be completed:\\n * cash on delivery needs no keys, free shipping needs no configuration. *\\\/\\n$vanam_cod = get_option( 'woocommerce_cod_settings', array() );\\nif ( ! is_array( $vanam_cod ) ) {\\n\\t$vanam_cod = array();\\n}\\nif ( empty( $vanam_cod['enabled'] ) || 'yes' !== $vanam_cod['enabled'] ) {\\n\\t$vanam_cod['enabled'] = 'yes';\\n\\t$vanam_cod['title'] = 'Cash on delivery';\\n\\t$vanam_cod['enable_for_virtual'] = 'yes';\\n\\tupdate_option( 'woocommerce_cod_settings', $vanam_cod );\\n}\\n\\nif ( class_exists( 'WC_Shipping_Zone' ) ) {\\n\\t$vanam_zone = new WC_Shipping_Zone( 0 ); \\\/\\\/ Anything not matched by another zone.\\n\\t$vanam_has_free = false;\\n\\tforeach ( $vanam_zone->get_shipping_methods() as $vanam_method ) {\\n\\t\\tif ( 'free_shipping' === $vanam_method->id ) {\\n\\t\\t\\t$vanam_has_free = true;\\n\\t\\t\\tbreak;\\n\\t\\t}\\n\\t}\\n\\tif ( ! $vanam_has_free ) {\\n\\t\\t$vanam_zone->add_shipping_method( 'free_shipping' );\\n\\t\\t$vanam_zone->save();\\n\\t}\\n}\\n\\n\\\/* ---------------------------------------------------------------------------\\n * 2. Plugin settings\\n *\\n * Image previews on: off is the right default for a real shop, where a file is\\n * often a PDF and a thumbnail adds nothing, but the demo carries a design proof,\\n * and seeing it is the fastest way to understand what the customer gets.\\n * ------------------------------------------------------------------------ *\\\/\\n\\nif ( class_exists( Settings::class ) ) {\\n\\tSettings::update( array( 'image_preview' => true ) );\\n}\\n\\n\\\/* The plugin is not there -- a failed install, a renamed class. Leave a working\\n * store rather than a fatal error in the middle of the preview. *\\\/\\nif ( ! class_exists( Storage::class ) || ! function_exists( 'wc_create_order' ) ) {\\n\\tupdate_option( 'vanam_demo_seeded', 1 );\\n\\treturn;\\n}\\n\\n\\\/* ---------------------------------------------------------------------------\\n * 3. The files\\n *\\n * Generated rather than shipped: a blueprint is one JSON file, and nothing in it\\n * can point at a binary. Real, valid files, so that downloading one from the\\n * preview opens a document rather than an error.\\n * ------------------------------------------------------------------------ *\\\/\\n\\n\\\/**\\n * A one-page PDF with a heading and a few lines, in the base Helvetica every\\n * reader has. The cross-reference offsets are measured, not hard-coded, so the\\n * file stays valid whatever the text is.\\n *\\\/\\n$vanam_pdf = function ( $title, array $lines ) {\\n\\t$escape = function ( $text ) {\\n\\t\\treturn str_replace( array( '\\\\\\\\', '(', ')' ), array( '\\\\\\\\\\\\\\\\', '\\\\\\\\(', '\\\\\\\\)' ), $text );\\n\\t};\\n\\n\\t$content = 'BT \\\/F1 22 Tf 64 740 Td (' . $escape( $title ) . \\\") Tj ET\\\\n\\\";\\n\\t$y = 700;\\n\\n\\tforeach ( $lines as $line ) {\\n\\t\\t$content .= 'BT \\\/F1 12 Tf 64 ' . $y . ' Td (' . $escape( $line ) . \\\") Tj ET\\\\n\\\";\\n\\t\\t$y -= 22;\\n\\t}\\n\\n\\t$objects = array(\\n\\t\\t'<< \\\/Type \\\/Catalog \\\/Pages 2 0 R >>',\\n\\t\\t'<< \\\/Type \\\/Pages \\\/Kids [3 0 R] \\\/Count 1 >>',\\n\\t\\t'<< \\\/Type \\\/Page \\\/Parent 2 0 R \\\/MediaBox [0 0 612 792] \\\/Resources << \\\/Font << \\\/F1 4 0 R >> >> \\\/Contents 5 0 R >>',\\n\\t\\t'<< \\\/Type \\\/Font \\\/Subtype \\\/Type1 \\\/BaseFont \\\/Helvetica >>',\\n\\t\\t'<< \\\/Length ' . strlen( $content ) . \\\" >>\\\\nstream\\\\n\\\" . $content . 'endstream',\\n\\t);\\n\\n\\t$pdf = \\\"%PDF-1.4\\\\n\\\";\\n\\t$offsets = array();\\n\\n\\tforeach ( $objects as $index => $body ) {\\n\\t\\t$offsets[] = strlen( $pdf );\\n\\t\\t$pdf .= ( $index + 1 ) . \\\" 0 obj\\\\n\\\" . $body . \\\"\\\\nendobj\\\\n\\\";\\n\\t}\\n\\n\\t$xref = strlen( $pdf );\\n\\t$pdf .= \\\"xref\\\\n0 \\\" . ( count( $objects ) + 1 ) . \\\"\\\\n0000000000 65535 f \\\\n\\\";\\n\\n\\tforeach ( $offsets as $offset ) {\\n\\t\\t$pdf .= sprintf( \\\"%010d 00000 n \\\\n\\\", $offset );\\n\\t}\\n\\n\\treturn $pdf . 'trailer << \\\/Size ' . ( count( $objects ) + 1 ) . \\\" \\\/Root 1 0 R >>\\\\nstartxref\\\\n\\\" . $xref . \\\"\\\\n%%EOF\\\\n\\\";\\n};\\n\\n\\\/**\\n * A mock business-card proof, drawn with GD. Empty when GD is missing, and the\\n * caller falls back to a PDF: a proof that cannot be previewed is better than no\\n * proof.\\n *\\\/\\n$vanam_png = function () {\\n\\tif ( ! function_exists( 'imagecreatetruecolor' ) ) {\\n\\t\\treturn '';\\n\\t}\\n\\n\\t$width = 700;\\n\\t$height = 400;\\n\\t$image = imagecreatetruecolor( $width, $height );\\n\\n\\t$paper = imagecolorallocate( $image, 247, 243, 236 );\\n\\t$ink = imagecolorallocate( $image, 40, 40, 40 );\\n\\t$muted = imagecolorallocate( $image, 120, 120, 120 );\\n\\t$accent = imagecolorallocate( $image, 127, 84, 179 );\\n\\t$card = imagecolorallocate( $image, 255, 255, 255 );\\n\\n\\timagefilledrectangle( $image, 0, 0, $width, $height, $paper );\\n\\n\\t\\\/\\\/ The card itself, with a bleed line around it, which is what a proof shows.\\n\\timagefilledrectangle( $image, 120, 90, 580, 330, $card );\\n\\timagerectangle( $image, 110, 80, 590, 340, $muted );\\n\\timagefilledrectangle( $image, 120, 90, 136, 330, $accent );\\n\\n\\timagestring( $image, 5, 170, 150, 'ANNA ROSSI', $ink );\\n\\timagestring( $image, 3, 170, 175, 'Graphic designer', $muted );\\n\\timagestring( $image, 3, 170, 250, 'anna@example.com', $ink );\\n\\timagestring( $image, 3, 170, 270, '+39 050 123456', $ink );\\n\\n\\timagestring( $image, 4, 24, 20, 'DESIGN PROOF - front - 85 x 55 mm', $accent );\\n\\timagestring( $image, 2, 24, 370, 'Grey line = bleed. Check spelling before approving.', $muted );\\n\\n\\tob_start();\\n\\timagepng( $image );\\n\\t$bytes = ob_get_clean();\\n\\timagedestroy( $image );\\n\\n\\treturn (string) $bytes;\\n};\\n\\n\\\/**\\n * Put generated bytes into an owner's protected folder, through the plugin.\\n *\\n * Written to the plugin's own temporary folder first and then adopted, which is\\n * exactly the route a chunked upload takes once its last piece has arrived.\\n *\\n * @return array|null The file fields of an attachment record.\\n *\\\/\\n$vanam_store = function ( $owner_type, $owner_id, $file_name, $bytes, $mime ) {\\n\\t$storage = new Storage();\\n\\t$dir = $storage->temp_dir();\\n\\n\\tif ( '' === $dir || '' === $bytes ) {\\n\\t\\treturn null;\\n\\t}\\n\\n\\t$temp = $dir . 'demo-' . wp_generate_password( 12, false ) . '.part';\\n\\n\\tif ( false === file_put_contents( $temp, $bytes ) ) {\\n\\t\\treturn null;\\n\\t}\\n\\n\\t$stored = $storage->adopt_for( $owner_type, $owner_id, $temp, $file_name );\\n\\n\\tif ( is_wp_error( $stored ) ) {\\n\\t\\twp_delete_file( $temp );\\n\\t\\treturn null;\\n\\t}\\n\\n\\treturn array(\\n\\t\\t'source' => Attachment::SOURCE_UPLOAD,\\n\\t\\t'file_path' => $stored,\\n\\t\\t'file_name' => $file_name,\\n\\t\\t'file_size' => strlen( $bytes ),\\n\\t\\t'mime' => $mime,\\n\\t);\\n};\\n\\n\\\/* ---------------------------------------------------------------------------\\n * 4. Products, each with a file of its own\\n *\\n * One of each visibility, so the three places a product file can appear are all\\n * demonstrated: the product page before buying, the order after buying, both.\\n * ------------------------------------------------------------------------ *\\\/\\n\\n$vanam_catalog = array(\\n\\t'business-cards' => array(\\n\\t\\t'name' => 'Custom Business Cards',\\n\\t\\t'price' => '39',\\n\\t\\t'file' => array(\\n\\t\\t\\t'title' => 'Artwork guidelines',\\n\\t\\t\\t'description' => 'Sizes, bleed and colour profile for the file you send us.',\\n\\t\\t\\t'name' => 'artwork-guidelines.pdf',\\n\\t\\t\\t'visibility' => ProductAttachments::VISIBLE_BOTH,\\n\\t\\t\\t'lines' => array(\\n\\t\\t\\t\\t'Card size: 85 x 55 mm, plus 3 mm bleed on every side.',\\n\\t\\t\\t\\t'Colour: CMYK, FOGRA39. Black text as 100% K.',\\n\\t\\t\\t\\t'Resolution: 300 dpi. Fonts outlined or embedded.',\\n\\t\\t\\t\\t'Keep text at least 4 mm inside the trim line.',\\n\\t\\t\\t),\\n\\t\\t),\\n\\t),\\n\\t'wedding-invitations' => array(\\n\\t\\t'name' => 'Wedding Invitation Set',\\n\\t\\t'price' => '120',\\n\\t\\t'file' => array(\\n\\t\\t\\t'title' => 'Paper and finish samples',\\n\\t\\t\\t'description' => 'The papers, weights and finishes the set can be printed on.',\\n\\t\\t\\t'name' => 'paper-and-finishes.pdf',\\n\\t\\t\\t'visibility' => ProductAttachments::VISIBLE_PRODUCT,\\n\\t\\t\\t'lines' => array(\\n\\t\\t\\t\\t'Cotton 600 g - soft, textured, takes letterpress well.',\\n\\t\\t\\t\\t'Pearl 300 g - light shimmer, best with foil.',\\n\\t\\t\\t\\t'Recycled kraft 350 g - natural, rustic.',\\n\\t\\t\\t\\t'Finishes: gold foil, blind emboss, deckled edge.',\\n\\t\\t\\t),\\n\\t\\t),\\n\\t),\\n\\t'poster-a2' => array(\\n\\t\\t'name' => 'Poster Print A2',\\n\\t\\t'price' => '25',\\n\\t\\t'file' => array(\\n\\t\\t\\t'title' => 'Framing and care guide',\\n\\t\\t\\t'description' => 'How to hang the poster and keep the colours from fading.',\\n\\t\\t\\t'name' => 'framing-and-care.pdf',\\n\\t\\t\\t'visibility' => ProductAttachments::VISIBLE_ORDER,\\n\\t\\t\\t'lines' => array(\\n\\t\\t\\t\\t'Let the print rest flat for 24 hours before framing.',\\n\\t\\t\\t\\t'Use UV-filtering glass away from direct sunlight.',\\n\\t\\t\\t\\t'Handle by the edges; dust with a dry, soft cloth.',\\n\\t\\t\\t),\\n\\t\\t),\\n\\t),\\n);\\n\\n$vanam_product_ids = array();\\n\\nforeach ( $vanam_catalog as $vanam_slug => $vanam_entry ) {\\n\\t$vanam_existing = get_page_by_path( $vanam_slug, OBJECT, 'product' );\\n\\n\\tif ( $vanam_existing ) {\\n\\t\\t$vanam_product_ids[ $vanam_slug ] = $vanam_existing->ID;\\n\\t\\tcontinue;\\n\\t}\\n\\n\\tif ( ! class_exists( 'WC_Product_Simple' ) ) {\\n\\t\\tcontinue;\\n\\t}\\n\\n\\t$vanam_product = new WC_Product_Simple();\\n\\t$vanam_product->set_name( $vanam_entry['name'] );\\n\\t$vanam_product->set_slug( $vanam_slug );\\n\\t$vanam_product->set_status( 'publish' );\\n\\t$vanam_product->set_catalog_visibility( 'visible' );\\n\\t$vanam_product->set_regular_price( $vanam_entry['price'] );\\n\\t$vanam_product->save();\\n\\n\\t$vanam_product_id = $vanam_product->get_id();\\n\\t$vanam_product_ids[ $vanam_slug ] = $vanam_product_id;\\n\\n\\t$vanam_file = $vanam_store(\\n\\t\\tStorage::OWNER_PRODUCT,\\n\\t\\t$vanam_product_id,\\n\\t\\t$vanam_entry['file']['name'],\\n\\t\\t$vanam_pdf( $vanam_entry['file']['title'], $vanam_entry['file']['lines'] ),\\n\\t\\t'application\\\/pdf'\\n\\t);\\n\\n\\tif ( $vanam_file ) {\\n\\t\\t( new ProductAttachments() )->save_all(\\n\\t\\t\\t$vanam_product_id,\\n\\t\\t\\tarray(\\n\\t\\t\\t\\tarray_merge(\\n\\t\\t\\t\\t\\t$vanam_file,\\n\\t\\t\\t\\t\\tarray(\\n\\t\\t\\t\\t\\t\\t'title' => $vanam_entry['file']['title'],\\n\\t\\t\\t\\t\\t\\t'description' => $vanam_entry['file']['description'],\\n\\t\\t\\t\\t\\t\\t'visibility' => $vanam_entry['file']['visibility'],\\n\\t\\t\\t\\t\\t\\t'created' => current_time( 'mysql' ),\\n\\t\\t\\t\\t\\t)\\n\\t\\t\\t\\t),\\n\\t\\t\\t)\\n\\t\\t);\\n\\t}\\n}\\n\\n\\\/* ---------------------------------------------------------------------------\\n * 5. Orders, with files\\n *\\n * All three belong to the signed-in account, so the visitor can open My account\\n * and see them as the customer does. The last one has no files of its own, on\\n * purpose: the Attachments column is easier to read with a zero next to the\\n * other counts.\\n * ------------------------------------------------------------------------ *\\\/\\n\\nwp_update_user(\\n\\tarray(\\n\\t\\t'ID' => 1,\\n\\t\\t'first_name' => 'Anna',\\n\\t\\t'last_name' => 'Rossi',\\n\\t)\\n);\\n\\n$vanam_orders = array(\\n\\tarray(\\n\\t\\t'product' => 'business-cards',\\n\\t\\t'status' => 'processing',\\n\\t\\t'days' => 1,\\n\\t\\t'files' => array(\\n\\t\\t\\tarray(\\n\\t\\t\\t\\t'kind' => 'proof',\\n\\t\\t\\t\\t'title' => 'Design proof - front',\\n\\t\\t\\t\\t'description' => 'Please check spelling and phone number<\\\/strong> before we print. Reply to the order email with any change.',\\n\\t\\t\\t\\t'emails' => array( 'customer_processing_order', 'customer_invoice' ),\\n\\t\\t\\t),\\n\\t\\t\\tarray(\\n\\t\\t\\t\\t'kind' => 'pdf',\\n\\t\\t\\t\\t'title' => 'Invoice',\\n\\t\\t\\t\\t'name' => 'invoice-1001.pdf',\\n\\t\\t\\t\\t'description' => '',\\n\\t\\t\\t\\t'emails' => array( 'customer_invoice', 'customer_completed_order' ),\\n\\t\\t\\t\\t'lines' => array(\\n\\t\\t\\t\\t\\t'Invoice 1001 - Custom Business Cards x 1',\\n\\t\\t\\t\\t\\t'Subtotal: EUR 39.00',\\n\\t\\t\\t\\t\\t'VAT (22%): EUR 8.58',\\n\\t\\t\\t\\t\\t'Total: EUR 47.58',\\n\\t\\t\\t\\t),\\n\\t\\t\\t),\\n\\t\\t),\\n\\t\\t'email_block' => 'Hi [customer_name], your files for order [order_number] are ready. You can also find them any time on [order_page_link].',\\n\\t),\\n\\tarray(\\n\\t\\t'product' => 'poster-a2',\\n\\t\\t'status' => 'completed',\\n\\t\\t'days' => 6,\\n\\t\\t'files' => array(\\n\\t\\t\\tarray(\\n\\t\\t\\t\\t'kind' => 'pdf',\\n\\t\\t\\t\\t'title' => 'Certificate of authenticity',\\n\\t\\t\\t\\t'name' => 'certificate-of-authenticity.pdf',\\n\\t\\t\\t\\t'description' => 'Signed and numbered. Keep it with the print.',\\n\\t\\t\\t\\t'emails' => array( 'customer_completed_order' ),\\n\\t\\t\\t\\t'lines' => array(\\n\\t\\t\\t\\t\\t'This print is number 12 of a limited run of 50.',\\n\\t\\t\\t\\t\\t'Printed on archival cotton paper with pigment inks.',\\n\\t\\t\\t\\t\\t'Signed by the artist.',\\n\\t\\t\\t\\t),\\n\\t\\t\\t),\\n\\t\\t),\\n\\t\\t'email_block' => '',\\n\\t),\\n\\tarray(\\n\\t\\t'product' => 'wedding-invitations',\\n\\t\\t'status' => 'on-hold',\\n\\t\\t'days' => 0,\\n\\t\\t'files' => array(),\\n\\t\\t'email_block' => '',\\n\\t),\\n);\\n\\n$vanam_attachments = new OrderAttachments();\\n\\nforeach ( $vanam_orders as $vanam_data ) {\\n\\tif ( empty( $vanam_product_ids[ $vanam_data['product'] ] ) ) {\\n\\t\\tcontinue;\\n\\t}\\n\\n\\t$vanam_order = wc_create_order( array( 'customer_id' => 1 ) );\\n\\n\\tif ( is_wp_error( $vanam_order ) ) {\\n\\t\\tcontinue;\\n\\t}\\n\\n\\t$vanam_product = wc_get_product( $vanam_product_ids[ $vanam_data['product'] ] );\\n\\tif ( $vanam_product ) {\\n\\t\\t$vanam_order->add_product( $vanam_product, 1 );\\n\\t}\\n\\n\\t$vanam_address = array(\\n\\t\\t'first_name' => 'Anna',\\n\\t\\t'last_name' => 'Rossi',\\n\\t\\t'email' => 'anna@example.com',\\n\\t\\t'address_1' => 'Via Roma 1',\\n\\t\\t'city' => 'Pisa',\\n\\t\\t'postcode' => '56100',\\n\\t\\t'country' => 'IT',\\n\\t);\\n\\t$vanam_order->set_address( $vanam_address, 'billing' );\\n\\tunset( $vanam_address['email'] );\\n\\t$vanam_order->set_address( $vanam_address, 'shipping' );\\n\\n\\t$vanam_order->set_payment_method( 'cod' );\\n\\t$vanam_order->set_payment_method_title( 'Cash on delivery' );\\n\\t$vanam_order->set_date_created( time() - (int) $vanam_data['days'] * DAY_IN_SECONDS );\\n\\t$vanam_order->calculate_totals();\\n\\t$vanam_order->set_status( $vanam_data['status'] );\\n\\t$vanam_order->save();\\n\\n\\t$vanam_order_id = $vanam_order->get_id();\\n\\n\\tforeach ( $vanam_data['files'] as $vanam_spec ) {\\n\\t\\t$vanam_file = null;\\n\\n\\t\\tif ( 'proof' === $vanam_spec['kind'] ) {\\n\\t\\t\\t$vanam_file = $vanam_store( Storage::OWNER_ORDER, $vanam_order_id, 'business-card-proof.png', $vanam_png(), 'image\\\/png' );\\n\\t\\t}\\n\\n\\t\\t\\\/\\\/ A PDF when asked for one, and also when the proof could not be drawn.\\n\\t\\tif ( ! $vanam_file ) {\\n\\t\\t\\t$vanam_name = isset( $vanam_spec['name'] ) ? $vanam_spec['name'] : 'business-card-proof.pdf';\\n\\t\\t\\t$vanam_lines = isset( $vanam_spec['lines'] ) ? $vanam_spec['lines'] : array( 'Anna Rossi - Graphic designer', 'anna@example.com - +39 050 123456' );\\n\\t\\t\\t$vanam_file = $vanam_store( Storage::OWNER_ORDER, $vanam_order_id, $vanam_name, $vanam_pdf( $vanam_spec['title'], $vanam_lines ), 'application\\\/pdf' );\\n\\t\\t}\\n\\n\\t\\tif ( ! $vanam_file ) {\\n\\t\\t\\tcontinue;\\n\\t\\t}\\n\\n\\t\\t$vanam_attachments->add(\\n\\t\\t\\t$vanam_order,\\n\\t\\t\\tarray_merge(\\n\\t\\t\\t\\t$vanam_file,\\n\\t\\t\\t\\tarray(\\n\\t\\t\\t\\t\\t'title' => $vanam_spec['title'],\\n\\t\\t\\t\\t\\t'description' => $vanam_spec['description'],\\n\\t\\t\\t\\t\\t'emails' => $vanam_spec['emails'],\\n\\t\\t\\t\\t)\\n\\t\\t\\t)\\n\\t\\t);\\n\\t}\\n\\n\\tif ( '' !== $vanam_data['email_block'] ) {\\n\\t\\t$vanam_attachments->save_options(\\n\\t\\t\\t$vanam_order,\\n\\t\\t\\tarray(\\n\\t\\t\\t\\t'embed_enabled' => true,\\n\\t\\t\\t\\t'embed_text' => $vanam_data['email_block'],\\n\\t\\t\\t)\\n\\t\\t);\\n\\t}\\n}\\n\\n\\\/* ---------------------------------------------------------------------------\\n * 6. Make the customer's pages reachable\\n *\\n * The visitor will click through to My account -> Orders -> View order, and\\n * those endpoints are rewrite rules. They are normally flushed on a later\\n * request; this preview has no later request to wait for.\\n * ------------------------------------------------------------------------ *\\\/\\n\\nflush_rewrite_rules();\\n\\n\\\/* ---------------------------------------------------------------------------\\n * 7. Freemius\\n *\\n * Skip the connection, so no opt-in screen or notice greets a visitor who only\\n * wanted to see the plugin. Guarded: Freemius state must never be able to break\\n * the preview.\\n * ------------------------------------------------------------------------ *\\\/\\n\\nif ( function_exists( 'vanam_fs' ) ) {\\n\\ttry {\\n\\t\\tif ( ! vanam_fs()->is_registered() ) {\\n\\t\\t\\tvanam_fs()->skip_connection();\\n\\t\\t}\\n\\t} catch ( \\\\Exception $e ) {\\n\\t\\t\\\/\\\/ Nothing to do: the preview works without it.\\n\\t}\\n}\\n\\n\\\/* Cancel Freemius' post-activation redirect.\\n *\\n * Freemius marks a fresh activation with a transient and, on the next admin page\\n * load, redirects to the plugin's own first page -- which would hijack the\\n * landing page and drop the visitor on Settings instead of the orders. The\\n * transient is what is_plugin_activation() reads, so removing it is enough;\\n * skip_connection() above does not clear it.\\n *\\\/\\ndelete_transient( 'fs_plugin_vanquish-attach-me-for-woocommerce_activated' );\\n\\nupdate_option( 'vanam_demo_seeded', 1 );\\n\"}]}"}},"all_blocks":{"vanquish-attach-me\/product-attachments":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":2,"name":"vanquish-attach-me\/product-attachments","title":"Product attachments","category":"widgets","icon":"paperclip","description":"A product's files: the current product's on a product page, or any product you pick.","keywords":["attachments","files","downloads","documents","manual"],"textdomain":"vanquish-attach-me-for-woocommerce","usesContext":["postId","postType"],"attributes":{"productId":{"type":"number","default":0},"place":{"type":"string","default":"all","enum":["all","tab","summary","after_cart"]},"showTitle":{"type":"boolean","default":true}},"supports":{"html":false,"align":["wide","full"],"spacing":{"margin":true,"padding":true}},"editorScript":"file:.\/index.js","style":"vanam-frontend"}},"tagged_versions":["1.0.0","1.0.1","1.1.0","1.2.0","1.3.0","1.4.0","1.5.0","1.6.0","1.6.1","1.6.2","1.6.3","1.6.4","1.6.5","1.7.0","1.7.1","1.7.2","1.7.3","1.8.0","1.9.0","1.9.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3744210,"resolution":"1","location":"assets","locale":"","width":1760,"height":2626},"screenshot-10.png":{"filename":"screenshot-10.png","revision":3761291,"resolution":"10","location":"assets","locale":"","width":2760,"height":1720},"screenshot-11.png":{"filename":"screenshot-11.png","revision":3766046,"resolution":"11","location":"assets","locale":"","width":2160,"height":666},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3744210,"resolution":"2","location":"assets","locale":"","width":1760,"height":2310},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3758606,"resolution":"3","location":"assets","locale":"","width":2316,"height":1934},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3758606,"resolution":"4","location":"assets","locale":"","width":2094,"height":986},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3758606,"resolution":"5","location":"assets","locale":"","width":2094,"height":2854},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3744210,"resolution":"6","location":"assets","locale":"","width":1438,"height":2654},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3744210,"resolution":"7","location":"assets","locale":"","width":1760,"height":1912},"screenshot-8.png":{"filename":"screenshot-8.png","revision":3744210,"resolution":"8","location":"assets","locale":"","width":2356,"height":3024},"screenshot-9.png":{"filename":"screenshot-9.png","revision":3744210,"resolution":"9","location":"assets","locale":"","width":2356,"height":1710}},"screenshots":{"1":"Files on a product: each one a row that says what is set on it. Open one to choose where the customer sees it, which variations it applies to and which order emails carry it. Availability, roles, download limits and the disclaimer are Premium.","2":"Files on an order, in the \"Files & proofs\" box: the emails each file goes with, and the switch for the block of download links in the order emails.","3":"The attachments tab on the product page, as a customer sees it before buying.","4":"My account: a \"View attachments\" button on each order that has files.","5":"The customer's order page: the files attached to the order, and the ones that came with the product they bought.","6":"Premium: a proof on the customer's order page \u2014 the file to approve, its versions, the conversation, and the answer.","7":"Premium: proofs on the order screen \u2014 every version and message, and the reply box.","8":"Premium: bulk attachments \u2014 one file for many products, with the products each rule reaches.","9":"Premium: clean up \u2014 choose which old orders lose their files. The next step says how many they are before anything is deleted.","10":"Premium: Mark up \u2014 the customer circles, points and writes their corrections on an image or PDF proof, and sends the drawing with their answer.","11":"Premium: the Proofs column in the orders list \u2014 each order's files to approve, and where each stands."}},"plugin_section":[],"plugin_tags":[232103,284860,280841,281068,283480],"plugin_category":[45,50],"plugin_contributors":[78154,269507],"plugin_business_model":[],"class_list":["post-366308","plugin","type-plugin","status-publish","hentry","plugin_tags-email-attachments","plugin_tags-file-approval","plugin_tags-order-attachments","plugin_tags-product-attachments","plugin_tags-proof-approval","plugin_category-ecommerce","plugin_category-media","plugin_contributors-freemius","plugin_contributors-vanquish83","plugin_committers-vanquish83","plugin_support_reps-supportvanquishplugins"],"banners":{"banner":"https:\/\/ps.w.org\/vanquish-attach-me-for-woocommerce\/assets\/banner-772x250.png?rev=3757217","banner_2x":"https:\/\/ps.w.org\/vanquish-attach-me-for-woocommerce\/assets\/banner-1544x500.png?rev=3757217","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/vanquish-attach-me-for-woocommerce\/assets\/icon-128x128.png?rev=3757196","icon_2x":"https:\/\/ps.w.org\/vanquish-attach-me-for-woocommerce\/assets\/icon-256x256.png?rev=3757196","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/vanquish-attach-me-for-woocommerce\/assets\/screenshot-1.png?rev=3744210","caption":"Files on a product: each one a row that says what is set on it. Open one to choose where the customer sees it, which variations it applies to and which order emails carry it. Availability, roles, download limits and the disclaimer are Premium."},{"src":"https:\/\/ps.w.org\/vanquish-attach-me-for-woocommerce\/assets\/screenshot-2.png?rev=3744210","caption":"Files on an order, in the \"Files & proofs\" box: the emails each file goes with, and the switch for the block of download links in the order emails."},{"src":"https:\/\/ps.w.org\/vanquish-attach-me-for-woocommerce\/assets\/screenshot-3.png?rev=3758606","caption":"The attachments tab on the product page, as a customer sees it before buying."},{"src":"https:\/\/ps.w.org\/vanquish-attach-me-for-woocommerce\/assets\/screenshot-4.png?rev=3758606","caption":"My account: a \"View attachments\" button on each order that has files."},{"src":"https:\/\/ps.w.org\/vanquish-attach-me-for-woocommerce\/assets\/screenshot-5.png?rev=3758606","caption":"The customer's order page: the files attached to the order, and the ones that came with the product they bought."},{"src":"https:\/\/ps.w.org\/vanquish-attach-me-for-woocommerce\/assets\/screenshot-6.png?rev=3744210","caption":"Premium: a proof on the customer's order page \u2014 the file to approve, its versions, the conversation, and the answer."},{"src":"https:\/\/ps.w.org\/vanquish-attach-me-for-woocommerce\/assets\/screenshot-7.png?rev=3744210","caption":"Premium: proofs on the order screen \u2014 every version and message, and the reply box."},{"src":"https:\/\/ps.w.org\/vanquish-attach-me-for-woocommerce\/assets\/screenshot-8.png?rev=3744210","caption":"Premium: bulk attachments \u2014 one file for many products, with the products each rule reaches."},{"src":"https:\/\/ps.w.org\/vanquish-attach-me-for-woocommerce\/assets\/screenshot-9.png?rev=3744210","caption":"Premium: clean up \u2014 choose which old orders lose their files. The next step says how many they are before anything is deleted."},{"src":"https:\/\/ps.w.org\/vanquish-attach-me-for-woocommerce\/assets\/screenshot-10.png?rev=3761291","caption":"Premium: Mark up \u2014 the customer circles, points and writes their corrections on an image or PDF proof, and sends the drawing with their answer."},{"src":"https:\/\/ps.w.org\/vanquish-attach-me-for-woocommerce\/assets\/screenshot-11.png?rev=3766046","caption":"Premium: the Proofs column in the orders list \u2014 each order's files to approve, and where each stands."}],"raw_content":"\n Vanquish Attach Me for WooCommerce lets you give each customer the files that belong to their order, straight from the order screen: the proof they have to approve, their invoice, a certificate, the finished design. They find them on their order page and in the order emails, behind private download links. Files that belong to a whole product \u2014 a manual, a size chart, a data sheet \u2014 work the same way, on the product page, after purchase, or both. Upload the file, pick one from the media library, or point at a URL.<\/p>\n\n Uploaded files are not left where a URL can find them: they sit behind server rules and an unguessable path, and they are served through an endpoint that checks who is asking \u2014 the customer who placed that order, or somebody who can manage the shop. That is not a setting you can turn off \u2014 it is the only correct way to serve a file attached to an order, so it is simply how the plugin works.<\/p>\n\n Large files go up in pieces, so your server's per-request upload limit is not the limit on what you can attach.<\/p>\n\n Proofs: file approval with your customer (Premium).<\/strong> Send a design, a print layout or a translation from the order for the customer to approve. They approve or reject it on their order page and you write to each other; every new version asks for approval again, and the whole history stays on the order. Reminders, automatic approval after a number of days, and a one-click import from the CodeCanyon plugin WooCommerce File Approval.<\/p>\n\n Screenshots, plans and answers on the plugin's page: vanquishplugins.com\/plugins\/attach-me<\/a>.<\/p>\n\n The free version does not send any data to external services.<\/strong> Files you upload stay on your own server, and the download links point at your own site.<\/p>\n\n This plugin uses Freemius<\/strong> to manage licensing and updates for the premium version, and to offer an optional opt-in when you first activate it. Nothing is sent unless you opt in or activate a licence; if you do, Freemius receives your site URL, WordPress and PHP versions and your administrator email address, in order to deliver updates and support. See freemius.com<\/a>, its terms<\/a> and its privacy policy<\/a>.<\/p>\n\n The premium version<\/strong> adds no external services of its own: bulk product attachments, approval, expiry, automatic emails and the manual notification all run on your site, and the emails go out through WooCommerce.<\/p>\n\n In a folder inside your uploads directory, three ways round at once. The plugin writes the rules that close a directory to direct access, in the forms Apache and IIS understand. Because nginx honours neither, the path is unguessable as well: each order's files sit under a directory name derived from a secret the plugin generates for your site, rather than from the order number, and every stored file keeps its own name with twelve random characters added.<\/p>\n\n And the way in is the only way in: every download goes through a signed link, which checks whether the person asking placed that order or can manage the shop.<\/p>\n\n There is no switch for any of this. A file attached to an order is private by definition, and an option to serve it insecurely would only ever be turned on by mistake.<\/p><\/dd>\n Yes. Files are sent to the server in pieces small enough to clear Both work. A media library file keeps its own public address in Yes, with HPOS and with the classic order storage.<\/p><\/dd>\n No. Your settings, your texts, the files on your products and the files on every order are converted for you. The importer runs from Attach Me \u2192 Settings \u2192 Import old data<\/strong>, a tab that appears as soon as the old plugin's data is found. It shows how much is left as it goes, and finishes in the background if you close the tab. An order is also converted the first time somebody opens it, whatever happened before.<\/p>\n\n Your files stay where they are on disk and keep working, and the old plugin's download links are still understood. A customer with an account follows one after signing in, and so do you.<\/p>\n\n A link to a guest<\/strong> order's file needs one thing more than the link. Those old URLs were built as The old plugin's data is left in place rather than deleted, so nothing is destroyed by importing. You can keep both installed while you check the result, then deactivate the old one.<\/p><\/dd>\n Yes: proofs are its successor, in Premium. Under Attach Me \u2192 Settings \u2192 Proofs \/ File approval<\/strong>, a card appears on any site that has its data, and imports it in one go: each file becomes a proof on its order, with its conversation, the files the customer sent and the customer's answer, each with its date. Its settings and preset answers can come along too. Nothing of the old plugin is changed or deleted, and the import can be run again: what was already imported is skipped.<\/p>\n\n File Approval replaced a file when a new one was sent and kept no history of it, so each proof starts with one version: the file as it is now. The files your customers sent are copied into the protected folder; File Approval kept them in a public one.<\/p><\/dd>\n Partly, and without doing anything. This plugin has a new name for its translations, so a translation made for \"WooCommerce Attach Me!\" or \"WooCommerce File Approval\" (with Loco Translate, say) does not apply to it as it is. But many texts did not change \u2014 \"Attachments\", \"Download \/ View\", \"Approve\", \"Reject\", \"Approved\", \"Rejected\" among them \u2014 and for those, when this plugin has no translation of its own, it uses yours. It finds the old files where WordPress and Loco Translate keep them, so the old plugin does not have to stay installed; nothing is copied or changed. Attach Me \u2192 Settings \u2192 Import old data<\/strong> shows whether one was found for your language.<\/p>\n\n The texts that changed are translated like the rest of the plugin, with Loco Translate for example, and the ones your customers see can also be set under Attach Me \u2192 Settings \u2192 Texts<\/strong>. The wording you had written in the old plugin's settings is imported with them.<\/p><\/dd>\nFree features<\/h4>\n\n
\n
[order_number]<\/code>, [customer_name]<\/code> and [order_page_link]<\/code> that a click writes into the text.<\/li>\nPremium features<\/h4>\n\n
\n
External services<\/h3>\n\n
More WooCommerce plugins by Vanquish<\/h4>\n\n
\n
\n
\/wp-content\/plugins\/vanquish-attach-me-for-woocommerce<\/code> directory, or install the plugin through the WordPress plugins screen.<\/li>\n\n
Where are the uploaded files kept?<\/h3><\/dt>\n
Can I attach a file that is bigger than my server's upload limit?<\/h3><\/dt>\n
upload_max_filesize<\/code> and post_max_size<\/code>, so neither caps what you can attach. The screen shows the maximum it will accept.<\/p><\/dd>\nWhat about files in the media library, or on another server?<\/h3><\/dt>\n
wp-content\/uploads<\/code> \u2014 that is how the media library works \u2014 so if a file must not be reachable by anyone holding its URL, upload it through the plugin instead of adding it to the library. An external URL is only ever a link: the plugin does not fetch somebody else's file to attach it to your emails.<\/p><\/dd>\nDoes it work with HPOS (High-Performance Order Storage)?<\/h3><\/dt>\n
I am migrating from the CodeCanyon \"WooCommerce Attach Me!\" plugin. Do I lose anything?<\/h3><\/dt>\n
?wcam_id=<order number>-<0, 1, 2...><\/code>, which anybody can type out, and a guest order has no account to check the visitor against \u2014 so on its own such a link is not proof of anything, and is refused. It works when the request also carries the order key, which is the token WooCommerce puts in the order links it emails: following the file from the customer's own order page works, pasting the bare old URL does not.<\/p>\n\nI use the CodeCanyon \"WooCommerce File Approval\" plugin. Can I move?<\/h3><\/dt>\n
Will my translations of the old plugin carry over?<\/h3><\/dt>\n