Description

Filter for the video post date that runs before the post is inserted into the database.

Parameters

$post_date

(string)(required) Post date formatted as Y-m-d H:i:s

Default:None

$video

(array)(optional) Video details returned by YouTube API.

Default:None

$theme_import

(array)(optional) If user chose to import videos for compatible WP theme, this variable will hold the theme details. Useful to separate posts created for the theme from regular video posts.

Default:None

Description

Filter that allows you to change the default ping status for the current video post before inserting it into the database.

Parameters

$status

(string)(required) The current ping status set from WordPress Settings page.

Default:Status set in WP Settings page.

$video

(array)(optional) Video details returned by YouTube API.

Default:None

$theme_import

(array)(optional) If user chose to import videos for compatible WP theme, this variable will hold the theme details. Useful to separate posts created for the theme from regular video posts.

Default:None

Description

Filter that allows you to change the default comment status for the current video post before inserting it into the database.

Parameters

$status

(string)(required) The current comment status set from WordPress Settings page.

Default:Status set in WP Settings page.

$video

(array)(optional) Video details returned by YouTube API.

Default:None

$theme_import

(array)(optional) If user chose to import videos for compatible WP theme, this variable will hold the theme details. Useful to separate posts created for the theme from regular video posts.

Default:None

Description

The video post status for the post that will be inserted into the database. Please see WP Codex Post Status for more details about the possible values.

Parameters

$post_status

(string)(required) The post status. Default value will be set to user preference from plugin Settings page. See Video import options for more details.

Default:None

$video

(array)(optional) Video details returned by YouTube API.

Default:None

$theme_import

(array)(optional) If user chose to import videos for compatible WP theme, this variable will hold the theme details. Useful to separate posts created for the theme from regular video posts.

Default:None

Description

Video post excerpt filter that runs before inserting the post into the database.

Parameters

$post_excerpt

(string)(required) The excerpt of the video post that will be inserted into the database.

Default:string

$video

(array)(optional) Video details returned by YouTube API.

Default:None

$theme_import

(array)(optional) If user chose to import videos for compatible WP theme, this variable will hold the theme details. Useful to separate posts created for the theme from regular video posts.

Default:None

Description

Video post content filter that runs before inserting the post into the database.

Parameters

$post_content

(string)(required) The post content that will be inserted into the database.

Default:string

$video

(array)(optional) Video details returned by YouTube API.

Default:None

$theme_import

(array)(optional) If user chose to import videos for compatible WP theme, this variable will hold the theme details. Useful to separate posts created for the theme from regular video posts.

Default:None

Description

Filter on post title, right before inserting the post into the database.

Parameters

$post_title

(string)(required) The title that will be set for the video post.

Default:None

$video

(array)(optional) Video details returned by YouTube API.

Default:None

$theme_import

(array)(optional) If user chose to import videos for compatible WP theme, this variable will hold the theme details. Useful to separate posts created for the theme from regular video posts.

Default:None

Description

Filter on video title. Useful to modify video title globally, for all subsequent filters and actions.

Parameters

$title

(string)(required) The video title returned by YouTube API.

Default:string

$import_title

(boolean)(optional) Import title option set by user in plugin settings.

Default:None

Description

Filter on video description. Useful to modify video description globally, for all subsequent filters and actions.

Parameters

$description

(string)(required) The video description returned by YouTube API.

Default:None

$import_description

(boolean)(optional) Import description value as set by the user in plugin Settings page.

Default:None

Description

By default, when trying to import a new single video, the plugin will display a simple form asking for the video ID. If you want to prevent this from happening, this filter can be used to prevent the plugin from overriding the single video import process.
This is useful in rare cases when WP theme uses the same post type as the plugin.

Parameters

$allow

(boolean)(required) Allow plugin to override the single post creation screen (true) or disallow it (false).

Default:true

Examples

Stop the plugin from overriding the single video creation.

add_filter( 'cbc_allow_single_video_import', '__return_false' );