Depending on your website, for videos imported by the plugin you might want to save some additional details or format title or content differently. This can be achieved by hooking to the filters or actions provided by the plugin.
These hooks should ideally be placed into your WordPress theme functions.php file. Even more, you should use a child theme instead of the parent theme and place all additional functionality into the child theme functions.php file. More on child themes can be found here: https://codex.wordpress.org/Child_Themes

Plugin Actions

Plugin Filters

Video details variable explained

As you may have already observed, the hooks above return some variables when called. From these, most important is the variable returned for video details since in most cases you may want to retrieve certain information from it and either process it or store it in post custom fields.

When a query is made to Vimeo, the plugin will store video details into an array for each video found into the feed. The complete structure for a single video looks like this:

array(
	'video_id'	=> The ID of the video,
	'uploader'	=> Video owner user name,
	'published' => Date of publishing on Vimeo,
	'updated'	=> Date of the last modification made to the video,
	'title'	=> The title of the video,
	'description' => The description of the video,
	'tags'	=> The array of video tags,
	'duration'	=> Duration of the video in seconds,
	'thumbnails'=> An array of thumbnails returned by Vimeo,			
	'stats'	=> An array of video statistics,
	'privacy'	=> The video privacy processed by the plugin,
	'size'	=> The size of the video		
);

Depending on the task you’re trying to do, you may want to use any of the details above to store or modify the video details. Below are all keys explained:

  • video_id : this is the key of the video array that holds the Vimeo video ID;
  • uploader: this key contains the Vimeo username of the user that owns the video;
  • published: the publishing date of the video as returned by Vimeo;
  • update: the last update date of the video;
  • title: the unformatted video title as returned by Vimeo;
  • description: the unformatted video description as returned by Vimeo;
  • tags: an indexed array of tags sorted in the exact order that Vimeo API returned them;
  • duration: the video duration in seconds;
  • thumbnails: an indexed array of thumbnails returned by Vimeo;
  • stats: an array of video statistics. The format of the array is:
    array(
    	'comments' 	=> Number of comments,
    	'likes' 	=> Number of likes,
    	'views' 	=> Number of views
    );
    
  • privacy: the video privacy that can have value public or private
  • size: an array containing the video size. The structure of the array is:
    array(
    	'width' => The video width as returned by Vimeo,
    	'height' => The video height as returned by Vimeo,
    	'ratio' => The width/height ratio
    );