=== Vimeotheque - Vimeo video importer WordPress plugin ===
Contributors: codeflavors, constantin.boiangiu
Tags: vimeo, video embed, vimeo embed, vimeo plugin, video post, vimeo import, video importer
Requires at least: 5.2
Tested up to: 5.7
Requires PHP: 5.6
Stable tag: trunk
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Intuitive Vimeo video importer to help you create video posts in seconds and sync your Vimeo collections with your WordPress website.

== Description ==

= Vimeo Video Importer Plugin =

**Vimeotheque** helps you to create video posts in your vlog, membership, online courses or any other video collection website by automatically importing public Vimeo videos and creating complete WordPress video posts from them.
https://vimeo.com/512419753
The video import process is fully automated and can be controlled by plugin options which allow you to choose the details that will be imported: title, content, featured image, tags and so on. Similarly, the video embed placed into the post content can be customized using the available plugin options for embedding the video.

= Vimeotheque importers =

With **Vimeotheque**, videos can be imported either individually, by providing the video URL on Vimeo or by searching or loading entire Vimeo channels, categories, showcases, groups, portfolios or user uploads and choosing which videos to import.

Please note that before being able to perform any imports you need to [create a Vimeo App](https://docs.vimeotheque.com/how-to-create-a-new-vimeo-app/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeotheque-readme "create a new Vimeo App") and enter the credentials into **Vimeotheque's** Settings page.

= Features =

* Responsive design: all video embeds managed by **Vimeotheque** are fully responsive and will fit any screen size;
* Vimeo HTML5 video player support: **Vimeotheque** uses the latest Vimeo player embed and follows all of Vimeo's embed recommendations;
* Multiple video embeds on the same page: Optimized to display multiple videos into the same page (ie. on post archive pages), **Vimeotheque** will allow only one video to play at a time;
* Compatible with the WordPress Block Editor: **Vimeotheque** features 3 blocks that allow you to quickly insert and edit them;
* Latest videos widget: The widget allows you to show video lists or playlists in your sidebars;
* Single video shortcode: **Vimeotheque** also keeps compatibility with the Classic editor;
* Import as custom post: Video posts created by **Vimeotheque** have post type *vimeo-video* to allow themes to customize the display of video posts;
* Full video import (title, description, thumbnail, video): **Vimeotheque** will create complete WordPress posts from the Vimeo videos;
* Single video import: An intuitive importer that requires only the video URL from Vimeo;
* Manual bulk import: The bulk video importer allows you to import multiple videos from channels, showcases, groups, user uploads, Vimeo searches or portfolios;
* Playlist themes: **Vimeotheque** can embed video playlists containing imported videos into other WordPress posts by using custom playlist themes;
* Automatic bulk import (**PRO version only**): Importer will import entire channels, showcases, groups, folders, user uploads or portfolios automatically, without any intervention;
* Import private videos (**PRO version only**): Videos having view privacy setup set to private can be queried and imported into WordPress;
* WordPress Theme support (**PRO version only**): For video themes, **Vimeotheque PRO** can import videos and create posts that have all custom fields required by the theme filled automatically;
* Import videos as regular post type (**PRO version only**): **Vimeotheque PRO** can import videos as regular post type instead of the custom post type implemented by the plugin;
* Priority support (**PRO version only**).

= Important links =

* [Vimeotheque PRO live demo](http://vvp-demo.codeflavors.com "Vimeotheque PRO live demo")
* [Vimeotheque plugin homepage](https://vimeotheque.com/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeo-lite-plugin-readme "Vimeotheque - Vimeo WordPress plugin")
* [Vimeotheque Knowledgebase and Help Center](https://docs.vimeotheque.com/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeotheque-readme "Vimeotheque Knowledgebase and Help Center")

**Vimeotheque initial setup**

* [Vimeotheque initial setup to query Vimeo videos](https://docs.vimeotheque.com/category/getting-started/vimeo-oauth/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeotheque-readme "How to create a new Vimeo App and set Vimeotheque to query videos from Vimeo")

**Vimeotheque custom post type setup**

* [How to change Vimeotheque's custom post type slug](https://docs.vimeotheque.com/changing-the-slug/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeotheque-readme "Change Vimeotheque's custom post type slug in WordPress")
* [How to solve Vimeotheque custom post type 404 error](https://docs.vimeotheque.com/how-to-solve-404-errors/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeotheque-readme "How to solve Vimeotheque custom post type 404 error")
* [How to add Vimeotheque custom post type taxonomies to WordPress custom menus](https://docs.vimeotheque.com/how-to-add-custom-post-type-to-wordpress-menus/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeotheque-readme "How to add Vimeotheque custom post type taxonomies to WordPress custom menus")

**Vimeotheque plugin options**

* [Vimeotheque imported content options](https://docs.vimeotheque.com/imported-content-options/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeotheque-readme "Vimeotheque imported content options")
* [Vimeotheque video embedding options](https://docs.vimeotheque.com/embed-options/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeotheque-readme "Vimeotheque video embedding options")

**Block editor**

* [Vimeotheque video position block](https://docs.vimeotheque.com/video-position-block/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeotheque-readme "Video position WordPress block editor block")
* [Vimeotheque single video block](https://docs.vimeotheque.com/single-video-block/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeotheque-readme "Single video WordPress block editor block")
* [Vimeotheque video playlist block](https://docs.vimeotheque.com/playlist-block/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeotheque-readme "Video playlist WordPress block editor block")
https://vimeo.com/512419883
**Importers**

* [Vimeotheque single video importer](https://docs.vimeotheque.com/single-video-import/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeotheque-readme "Vimeotheque single Vimeo video importer")
* [Vimeotheque manual bulk video importer](https://docs.vimeotheque.com/manual-bulk-import/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeotheque-readme "Vimeotheque manual bulk Vimeo video importer")

**Debugging**

* [Vimeotheque importer debug add-on](https://docs.vimeotheque.com/debug-add-on/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeotheque-readme "Vimeotheque importer debug add-on")
* [Vimeotheque system information](https://docs.vimeotheque.com/system-information/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeotheque-readme "Vimeotheque system information")

== Installation ==

Like any other plugin, it can be installed manually or directly from WordPress installation Plugins page. 

Once activated a new menu entry will be created called **Videos** (look for the Vimeo logo).

In order to be able to perform any imports, you will first need to register the plugin as an app on Vimeo website. Registration can be made [here](https://developer.vimeo.com/apps/new "register Vimeo app"). Please note that you must have a Vimeo account before you can register the app.
After successfull registration, go to plugin page **Settings** and under **Vimeo authentication** enter your consumer and secret key provided by Vimeo. Now you can make bulk imports.

For a detailed tutorial on how to set up Vimeo access registration, please see [this tutorial](https://docs.vimeotheque.com/how-to-create-a-new-vimeo-app/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeotheque-readme "How to set up Vimeo OAuth").

== Frequently Asked Questions ==

= Why can't I import Vimeo videos as WordPress posts? =

Before being able to perform any imports you must first create a Vimeo App for the plugin and enter the credentials into the plugin Settings page.
For a detailed tutorial on how to set up Vimeo access registration, please see [this tutorial](https://docs.vimeotheque.com/how-to-create-a-new-vimeo-app/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeo-lite-plugin-readme "How to set up Vimeo OAuth").

= How can I import hidden Vimeo videos as WordPress posts? =

If you would like to create video posts from hidden Vimeo videos you will need [Vimeotheque PRO](https://vimeotheque.com/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeo-lite-plugin-readme "Vimeotheque PRO").

= How do I import video image as post featured image? =

For each video post created by the plugin you have the option in post edit screen to import the video image as post featured image. The option is available in "Featured Image" metabox, just click the button "Import Video image" and the plugin will take care of the rest.

== Screenshots ==

1. Vimeotheque import single video - step 1
2. Vimeotheque import single video - step 2
3. Vimeotheque import single video - step 3
4. Vimeotheque video position block
5. Vimeotheque single video embed block
6. Vimeotheque single video block usage
7. Vimeotheque playlist block usage
8. Vimeotheque recent videos widget
9. Vimeotheque recent videos widget javascript playlist options
10. Vimeotheque video categories widget
11. Vimeotheque Debug add-on
12. Vimeotheque create status report

== Changelog ==
= 2.0.21 =
- Solved a bug in Video Position Block that cause post saving error/notice when editing a video post managed by Vimeotheque;
- Changed Video Position Block options "Video start time" and "Volume" to range controls;
- Added new option in Video Position Block for video embed background transparency;
- Added new option for videos edited using the Classic Editor to set the video embed background transparency;
- Increased Vimeotheque minimum WordPress version requirement to  WordPress 5.3 ( for support of object meta type in the REST API );
- Made video background transparency a global option in Vimeotheque Settings, under tab "Embed options";
- Solved a bug in Video Player script implemented by Vimeotheque which caused the player to ignore the embed volume option.

= 2.0.20 =
- Solved a bug in Playlist shortcode and Playlist block that prevented manually selected "vimeo-video" posts from being displayed into the playlist while option "Video post is public" was checked in plugin settings;
- Solved a bug in Playlist block that caused the block to crash when selecting videos imported as regular posts while having to PRO add-on active.

= 2.0.19 =
- Solved a bug in playlist theme "Default" that prevented clicking on the read more link when showing the excerpts into the playlist.

= 2.0.18 =
- Solved a bug that issued error "Call to a member function get_page() on null" when Jetpack installed.

= 2.0.17 =
- Added option for muted video in Classic editor;
- Added option for muted video in Video Position block;
- Added option for background mode in Classic editor;
- Added option for background mode in Video Position block;
- Added options dependency in Classic editor which hides options that don't apply when certain options are selected (ie. background mode disables a number of options);
- Added option for Classic editor to set the video start time when editing a video;
- Added option for Block editor to set the video start time when editing a video;
- Order showcases by default by "modified_time";
- Order user uploads feed by default by "date".

= 2.0.16 =
- Solved an issue with importers that were prevented from using the default sorting value;
- Solved a rare bug that caused errors when checking for duplicates and the feed returned from the Vimeo API was empty.

= 2.0.15 =
- Created a new option in Block Editor for playlist theme "Default" to display video thumbnails using the original size ratio (thumbnails in list might have different size) or have them displayed with the same size (thumbnails in list might have black bars);
- Created a new option in Classic Editor shortcode visual interface for theme "Default" to display video thumbnails size ratio in original size or the same size for all thumbnails.

= 2.0.14 =
- Video player adds class "loaded" on the video container once the video is loaded;
- Modified video player display to remove the black background and loader image after the video has loaded;
- Improved processing of tabs in plugin Settings.

= 2.0.13 =
- Solved a bug in Video Playlist Widget that caused the widget to display videos from all categories even if a category was selected from the widget options.

= 2.0.12 =
- Added date limit for showcase and channel;
- Made image preloader in playlist themes to use the 640px wide image version for videos.

= 2.0.11 =
- Solved a bug that caused the Video Playlist Block to crash when custom post type "vimeo-video" had no categories set up;
- Added "empty results" message to Video Playlist Block modal window if there are no categories set up for the plugin's custom post type;
- Improved display of options for Video Playlist Block theme "Default".

= 2.0.10 =
- Solved a bug that prevented the "Add new" plugin admin page from being displayed in some cases (ie. when using WooCommerce without the Classic editor plugin).

= 2.0.9 =
- Solved a bug in single video embed block that was causing the options for "Loop video" and "Autoplay video" to be always on.

= 2.0.8 =
- Solved a bug in block "Video position" which caused the player color to be loaded incorrectly when loading the default color set in plugin Settings under Embed options;
- Improved video position block for Block editor to allow additional parameters to be set;
- Added new parameter to filter "vimeotheque\player\embed-parameters" which passes any manually set embed options;
- Added new action "vimeotheque\automatic_embed_in_content" which is triggered when Vimeotheque embeds videos into the post content automatically (normally, when the Classic editor is used instead of the Block editor);
- Added new action "vimeotheque\editor\classic-editor-options-output" which is triggered when Vimeotheque displays the embedding options in post edit screen in Classic editor;
- Introduced actions and filters that allow third party plugins to add new block editor options to video position block.

= 2.0.7 =
- Added filter "vimeotheque\player\embed-parameters" that allows extra parameters to be added to the video embed iframe URL;
- Updated translation file for Romanian.

= 2.0.6 =
- Created new option for playlist block to display post excerpts in playlists for theme Default;
- Created new option for playlist block to allow various posts ordering options;
- Created new option for playlist widget to display post excerpts in playlists when using theme Default;
- Created new option for playlist shortcode in Classic editor to display post excerpts when using theme Default;
- Created new option for playlist shortcode to allow various posts ordering options;
- Introduced support for AMP plugin.

= 2.0.5 =
- Solved occasional single video import error caused by conflicts with third party plugins;
- Introduced player embed option to prevent tracking users, including all cookies and stats;
- Show manually selected videos in playlist shortcode into the exact order that they were selected;
- Preserve videos order in playlist block same as the order they were selected;
- Hide video position block that is introduced automatically into the block editor for Vimeotheque video posts if automatic embedding is disabled by filter.

= 2.0.4 =
- Stop video player script in case of player error to avoid JavaScript errors in page;
- Re-initialize video playlist script in case the player script returned an error;
- Compatibility with WP plugin "Complianz – GDPR/CCPA Cookie Consent" by "Really Simple Plugins".

= 2.0.3 =
- Solved a bug in Video Position block that disregarded the option to embed videos in archive pages and always embedded them;
- Updated Vimeotheque hooks PHPDoc comments in plugin files;
- Introduced actions and filters to OAuth plugin settings instructions;
- Exposed REST_Api object for new endpoints registrations;
- Introduced Vimeo API request method.

= 2.0.2 =
- Introduced add-ons management that allow installation of add-ons for various purposes;
- Added option for playlist block to set alignment;
- Optimized resizing for playlist block theme Default;
- Added option for video position block to set alignment;
- Added option for single video embed to set alignment;
- Added option to display manual bulk imports by the order set on Vimeo (applies only for showcase, channel, portfolio, user uploads and folder );
- New plugin Settings option for embed alignment.

= 2.0.1 =
* Added changelog file;
* Implemented filters to hide various plugin notices;
* Solved bug that wasn't hiding the video when using the appropriate filter to prevent auto embedding in post content using the block editor.

= 2.0 =
* Plugin requires at least WordPress 5.2 and PHP 5.6;
* Vimeotheque 2 functions as base for Vimeotheque PRO 2;
* Introduced 3 blocks for the block editor: video position (for video posts), single video embed and playlist embed;
* Allows import of more than 1 tag;
* Allows setup of tags when making manual bulk imports;
* Manual bulk import allows search within the results and ordering;
* Allows import of featured image automatically, when the video is imported;
* Redesigned manual bulk import into a friendlier grid interface app;
* Redesigned single video import into a stepped process app;
* Introduced status page that can output environment varialbles useful for debugging;
* Made custom post type video slugs editable from plugin settings; 
* Vimeo player script uses the new Vimeo player API.

= 1.3.5 =
* Introduced user ID parameter to queries for Vimeo showcases.

= 1.3.4 =
* Solved WP 5.4 redirect bug from plugin Settings page;
* Removed contextual help deprecated filter.

= 1.3.3 =
* Solved a bug that prevented video imports when one of the videos in feed had an empty description.

= 1.3.2 =
* Removed SSL verification for requests to Vimeo API to prevent cURL SSL errors on installations with older libraries when making requests to the API.

= 1.3.1 =
* Renamed plugin to "Vimeotheque Lite";
* Redirected all links to new, plugin dedicated URL: https://vimeotheque.com

= 1.3 =
* Added (initial) compatibility with Gutenberg editor.

= 1.2.8 =
* Added search filter when importing videos from user uploads, channels, albums or groups.

= 1.2.7 =
* Added privacy policy information which is displayed into WordPress's Privacy Policy Guide.

= 1.2.6.1 =
* Solved a translation bug that was generating errors in plugin Settings page;
* Modified video post checking to look for the queried object instead of using the global $post variable;
* Converted all necessary Vimeo URLs to https.

= 1.2.6 =
* Added option to import video publish date on Vimeo;
* Added option to import and set 1 video tag retrieved from Vimeo;
* Added option to embed videos by iframe instead of using the JavaScript embedding;
* Added option to allow individual video posts to override the embed aspect ratio set in plugin Settings with the actual ratio of the video;
* Vimeo OAuth API keys are not visible anymore after setting and validating the keys in plugin Settings page;
* Added possibility to import video image as post featured image in video post edit screen;
* Confined review request to be displayed only on plugin pages to avoid WP admin notices clutter;
* Introduced "About" page on plugin activation that displays messages about the current update and other useful information;
* Introduced embed aspect ratio 2.35:1 in addition to 16:9 and 4:3.

= 1.2.5.4 = 
* Added styling to front-end video embed to display a loading icon before video has finished loading in page;
* Minimized front-end video embed script and created a developer file of the script;
* Modified post type "vimeo-video" to also support trackbacks, custom fields, comments, revisions and post formats; 
* Modified video import to set post format to video for all imported Vimeo videos;
* Implemented filter "cvm_import_post_format" that can be used to change post format for all videos that are going to be imported after filter implementation;
* Implemented filters [cvm_video_post_title](https://vimeotheque.com/documentation/vimeo-video-post-filters/cvm_video_post_title/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeo-lite-plugin-readme), [cvm_video_post_content](https://vimeotheque.com/documentation/vimeo-video-post-filters/cvm_video_post_content/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeo-lite-plugin-readme), [cvm_video_post_excerpt](https://vimeotheque.com/documentation/vimeo-video-post-filters/cvm_video_post_excerpt/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeo-lite-plugin-readme) and [cvm_video_post_status](https://vimeotheque.com/documentation/vimeo-video-post-filters/cvm_video_post_status/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeo-lite-plugin-readme).

= 1.2.5.3 =
* Implemented REST API functionality;
* Solved a rare bug when selecting video posts for plugin shortcode that was displaying all registered posts in website instead of only the video posts if a third party script was implementing "pre_get_posts" filter;
* Added new PHP class to handle all WP REST API functionality.

= 1.2.5.2 =
* Solved a JavaScript bug that was preventing volume to be set to 0 (mute);
* Added friendly, user dismissible notice asking for plugin review on WordPress.org (thank you in advance for your review). 

= 1.2.5.1 =
* Solved a JavaScript bug that was preventing the volume setting from being set on videos embedded by the plugin;
* Solved a bug that was setting embed color scheme to red (#FF0000) by default even when not filled.

= 1.2.5 =
* Solved a bug that was displaying the video on password protected posts even if the correct password was not provided;
* Updated several documentation links;
* Added JSON "fields" parameter to requests to Vimeo API in order to increase the number of requests per hour.

= 1.2.4 =
* Updated player embed script to only use the iframe player embed (removed deprecated Flash player entirely).
* Wrapped widget classes in conditional statements to avoid PHP errors when certain page builders are used.

= 1.2.3 = 
* Solves a rare, ocasional mixed content error when using https and images from Vimeo aren't delivered over https.

= 1.2.2 =
* Solved a bug related to playlist shortcode that was preventing videos from being embedded in certain cases.

= 1.2.1 =
* Solved a shortcode bug that was preventing videos from being embedded when using the single video shortcode in pages or posts.

= 1.2 =

* Video embed details available as data-... attributes on video div element;
* Added tags to video post type;
* Added filter 'cvm_automatic_video_embed' that can be used to prevent embeds to be made by the plugin automatically (return false from callback function);
* Added translation files;
* Added various templating and utility functions;
* Now compatible with the [tutorial](https://vimeotheque.com/documentation/advanced-tutorials/using-vimeo-video-post-plugin-in-wp-theme/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeo-lite-plugin-readme "Using Vimeotheque plugin in WordPress theme") on how to create template files for the custom post type.

= 1.1.3 =

* Added custom post type "vimeo-video" archive (modified has_archive parameter to reflect public settings from Plugin settings)

= 1.1.2 =

* Vimeo video player SSL compatible

= 1.1.1 =

* Plugin compatible with WordPress 4.3 (scheduled for release on August 18th, 2015);
* Added Vimeo video albums import (not functional in version 1.1).

= 1.1 =
* Compatibility with Vimeo OAuth2;
* Restructured plugin Settings page into tabs for easier options management.

= 1.0 =
* Initial release

== Upgrade Notice ==

= 1.2.6 =
After upgrading to this version, single video imports won't work anymore unless you enter your Vimeo App client identifier and client secret. More about how to register an App on Vimeo here: [How to setup Vimeo OAuth](https://vimeotheque.com/documentation/getting-started/vimeo-oauth-new-interface/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeo-lite-plugin-readme "Vimeo OAuth setup")

== Troubleshooting ==

Plugin was tested with latest WordPress version and all default WordPress themes in all major browsers and also mobile devices. 
If anything is wrong on your installation, please [contact us](https://codeflavors.com/contact/?utm_source=wordpressorg&utm_medium=readme&utm_campaign=vimeo-lite-plugin-readme "Contact us") and tell us the theme you're using, WordPress version and browser/device used for testing.