Video Sales for Woocommerce with Vimeo Plugin

• Go to https://developer.vimeo.com/apps/new (Log in or create in account if you don’t have one already)
• Select a name and description for your app; these are arbitrary, but you can set something like “Vimeo Woocommerce” if you’d like
• For the “Will people besides you be able to access your app?” option, select “No”
• If you agree to the terms of service, check the box and click “Create App”
• You will be taken to your Vimeo App’s config page
• The Client Identifier and Client Secret are already generated, but we need to generate an Access Token
• Scroll to the “Authentication” section
• Under “Generate an access token” select the radio button that says “Authenticted (You)”
• Some checkboxes should appear to select “Scopes”. Check only the “Public” & “Private” Scopes
• Click the gray “Generate” button just below the checkboxes
• Immediately copy that token you generated into your configuration options; it will not be accessible once you reload this page
• Also copy your Client Secret and Client Identifier into the Video Sales for Woocommerce with Vimeo plugin options at https://your-site.com/wp-admin/admin.php?page=wc-settings&tab=vimeo (see screenshot 1)
• Save — you’re good to go!

Products with Vimeo videos selected have a lot of extra meta data associated with the Vimeo video stored on them. You can access this data in your email templates, as it is stored as custom fields on the Product. The names of the custom fields are:

• wc_vimeo_id: The ID of the Vimeo video; the ID in the Vimeo URL https://vimeo.com/18293829
• wc_vimeo_password: The password needed to access the video (will only be set if video is password protected at Vimeo)
• wc_vimeo_link: The link to the Vimeo video (this is a full link https://vimeo.com/18293829)
• wc_vimeo_name: The name, or title of the Vimeo video
• wc_vimeo_uri: The uri of the Vimeo video (this is the link without the leading domain, e.g. /18293829)
• wc_vimeo_description: The description of the video, if set
• wc_vimeo_duration: The duration of the video, in seconds
• wc_vimeo_status: The status of the video, if it is available to be viewed

This plugin works by setting meta data from the Vimeo video on the Product when you select a video. There are many ways to deliver this meta data to your users on purchase of a product.

One way is to create an email template in your theme. See the sample gist here: https://gist.github.com/vastolf/42cc9359d6b616675d70659e6de6f7a4

Copy the content of the gist. In your theme (or child theme’s) folder create a file at /woocommerce/emails/customer-completed-order.php and copy the contents of the gist into that file. So the full directory would be /wp-content/themes/{your theme or child theme}/woocommerce/emails/customer-completed-order.php

This gist gives some examples of how to access the Video data in your confirmation email, but you could do something similar in the processing email or other confirmation emails. You can edit this file and reformat it to suit your styling tastes.

For more information about custom WooCommerce emails, see the section called “Creating Custom Templates with Code” at https://woocommerce.com/posts/how-to-customize-emails-in-woocommerce/

This is likely due to caching. Video Sales for Woocommerce with Vimeo uses WordPress transients, a way of caching data that is resource intensive to generate or access.

This greatly increases performance, as your site doesn’t need to make a direct request to Vimeo every time it needs to check video data, and can instead use data from a recent request that already completed. This cache is set to clear every 15 minutes by default.

Note that depending on how many videos you have at Vimeo, making requests to get video data can be resource intensive. If you have many videos, you might consider increasing the cache clearing interval.

You can change the cache clear interval or clear the cache manually at https://your-site.com/wp-admin/admin.php?page=wc-settings&tab=vimeo (see screenshot 2)

If you’ve made a change to some video data at Vimeo, those changes may not be reflected on your site immediately.

To ensure that this plugin can work with other plugins that use meta data from the Product, a Vimeo video’s data gets stored on each individual Product it gets associted with.

For example, if you have a video at Vimeo with a name like “My Video” and you change it to “My Film”, any Products that had the “My Video” video from Vimeo selected will need to be updated when the Cron task runs for this plugin.

Products with Vimeo videos get checked for updates from Vimeo during the Cron task, which runs automatically on a set time interval, and which you can set yourself (default is every 15 minutes). Settings for Cron are at https://your-site.com/wp-admin/admin.php?page=wc-settings&tab=vimeo (see screenshot 2)

When the Cron task runs, all video meta data on the Products that needs updating gets updated. This shouldn’t be too much of an issue unless you have an update from Vimeo you need reflected immediately on your site; in that case, run the cron manually on the WooCommerce > Settings > Vimeo page