WordPress Filters

Visual Portfolio has several WP hooks that let you extend functionality.

All Filters

Filter NameAttributesDescription
vpf_include_template$template, $template_name, $argsinclude php template
vpf_include_template_args$args, $template_namefilter arguments added to the template
vpf_include_template_style$template, $template_name, $deps, $ver, $mediainclude css template
vpf_control_value$value, $name, $post_idget option for Layout
vpf_registered_control_args$argscalled for each control printed in the Layouts editor. Helpful when you need to change controls default values
vpf_registered_controls$controlscalled for all available controls printed in the Layouts editor. Helpful when you need to change controls default values
vpf_register_block_attributes$attributes, $controlsfilter registered block attributes
vpf_register_block_attribute_data$data, $controlfilter each control attribute data separately
vpf_extend_posts_source$sourcesextend posts sources
vpf_extend_portfolio_data_attributes$attrs, $optionsportfolio data attributes array
vpf_extend_portfolio_class$class, $optionsportfolio class string
vpf_extend_query_args$items, $optionsarguments for items query
vpf_extend_image_controls$controls, $namesingle image options in content source image
vpf_each_item_tag_name$tag_name, $argschange each item tag name (article or div by default used)
vpf_each_item_tag_attrs$attrs, $argscustomize each item tag attributes
vpf_each_item_args$argsextend data of each item
vpf_post_item_args$argsextend data of each post-based item
vpf_image_item_args$argsextend data of each image item
vpf_popup_image_data$argsextend data of each popup image
vpf_get_pagenum_link$current_url, $query_argfilter pagenum URLs used in filters and pagination

Extend Layouts

Filter NameAttributesDescription
vpf_extend_layouts$layoutscustom layouts
vpf_extend_layout_NAME_controls$controlsextend specific layout controls by NAME

Note: On the portfolio will be added data attribute [data-vp-layout=”new_layout”], so you can play with it and use jQuery events to initialize the new layout.

Extend Tiles

Filter NameAttributesDescription
vpf_extend_tiles$tilescustom tiles

Example: 3|1,0.5|2,0.25|

  • 3 columns in row
  • First item 100% width and 50% height
  • Second item 200% width and 25% height

Extend Items Styles

Filter NameAttributesDescription
vpf_extend_items_styles$items_stylescustom items styles
vpf_extend_item_style_NAME_controls$controlsextend specific items styles by NAME
vpf_items_style_builtin_controls$optionsextend the list of default builtin_controls

Note: Make sure that you added template in your_theme/visual-portfolio/items-list/items-style/new_items_style. See the structure of default templates to getting started.

Extend Filters

Filter NameAttributesDescription
vpf_extend_filters$filterscustom filters
vpf_extend_filter_items$items, $optionsarray with filter items
vpf_extend_filter_NAME_controls$controlsextend specific filters by NAME

Note: Make sure that you added template in your_theme/visual-portfolio/items-list/filter/new_filter. See the structure of default templates to getting started.

Extend Sorts

Filter NameAttributesDescription
vpf_extend_sort$sortcustom sorts
vpf_extend_sort_items$items, $optionsarray with sort items
vpf_extend_sort_NAME_controls$controlsextend specific sorts by NAME

Note: Make sure that you added template in your_theme/visual-portfolio/items-list/sort/new_sort. See the structure of default templates to getting started.

Extend Paginations

Filter NameAttributesDescription
vpf_extend_pagination$paginationcustom pagination
vpf_extend_pagination_NAME_controls$controlsextend specific paginations by NAME
vpf_pagination_item_data$item_data, $args, $vp_optionsfilter each pagination item data

Note: Make sure that you added template in your_theme/visual-portfolio/items-list/pagination/new_pagination. See the structure of default templates to getting started.

Lazy Loading

Filter NameAttributesDescription
vpf_lazyload_images_blocked_classes$blocked_classesskip image from lazy loading if image tag contains one of the provided classes
vpf_lazyload_images_blocked_src$blocked_srcskip image from lazy loading if image src contains one of the provided strings
vpf_lazyload_images_blocked_attributes$blocked_attributesskip image from lazy loading if image tag contains one of the provided attributes
vpf_lazyload_skip_image_with_attributes$skip, $attributesmanually skip image from lazy loading by return true
vpf_lazyload_images_new_attributes$attributesfilter the new set of attributes in lazy loaded image
vpf_lazyload_image_placeholder$placeholderimage URL for of placeholder displayed on the images while lazy loading

Dynamic CSS Render

Helpful filters for controls dynamic CSS render.

Filter NameAttributesDescription
vpf_controls_dynamic_css_value$value, $options, $control, $selector, $datafilter dynamic CSS value of control
vpf_controls_dynamic_css_styles_array$styles_array, $selector, $val, $data, $options, $controlfilter dynamic styles of control
Was this page helpful?