Exopite Multifilter / Advanced filters
WordPress Plugin
- Author: Joe Szalai
- Version: 20201020
- GitHub URL: https://github.com/JoeSz/exopite-multifilter/
- Plugin URL: https://www.joeszalai.org/exopite/multifilter/
- Demo URL: https://www.joeszalai.org/exopite/multifilter/exopite-multifilter-demos/
- Author URL: https://www.joeszalai.org
- License: GNU General Public License v3 or later
- License URI: http://www.gnu.org/licenses/gpl-3.0.html
IMPORTANT
From version 20190711
- taxonomies_terms changed to include_taxonomies, select posts in taxonomies, terms are not allowed
filter will be displayed default. - Update URL changed, need to update manually once!
DESCRIPTION
Exopite multifilter, mutlisortable, multi selectable, multi filterable sortable Wordpress Plugin
AJAX sorter/filter for any page or post types by multiple taxonomies or terms.
(like post by categories/tags or any custom post type taxonomies like "portfolio-categories").
Plugin working with a basic Bootstrap 4 Flex grid. Only enqueued, if style with 'bootstrap' or 'bootstrap-4' slug not already enqueued.
- Working with any Themes and any post types.
- Multiple styles as normal, same height, masonry, timeline, gallery or carousel (slider).
- Single or multiple filter based on taxonomies and terms. Multi selectable.
- Search in pre-selected taxonomies and terms.
- Wordking via shortcode, can be used multiple times on a posts or pages (or any custom post types).
- AJAX pagination.
- AJAX infinite loading.
- AJAX read more loading.
- Update browser URL with infintie or read more loading based on page and scroll position.
- Store session (page number, selected filters and search).
Useful if visitor is hit back or click on back button (if any) on the sinlge page/post. - Bootstrap 4 Flex grid.
- JavaScript Hooks.
https://github.com/carldanley/WP-JS-Hooks - Translatable via po/mo files. Pot included.
- Multiple hover effects.
https://tympanus.net/Development/HoverEffectIdeas/index.html
https://tympanus.net/Development/HoverEffectIdeas/index2.html
Note
With Lazy load the masonry-desandro type not working completly nice.
Live preview
| Mutlifilter with read more | Display without filer and gap | Slider |
|---|---|---|
 |
 |
 |
| Masonry | Zig Zag | Equal height with title and excerpt |
|---|---|---|
 |
 |
 |
| Timeline | Regular Blog | Multi-slider |
|---|---|---|
 |
 |
 |
USAGE
The plugin working via [exopite-multifilter] shortcodes, does not display any admin options.
You can use multiple shortcodes on the same page/post. On posts with 'pretty' permalink, pagination not working well.
Examples:
- To display posts with a selected categories, eg.:
[exopite-multifilter thumbnail-size-single-row="your-big-size" thumbnail-size-multi-row="your-small-size" posts_per_page="6" posts_per_row="3" effect="goliath" pagination="readmore" taxonomy_terms__in="category(cat1-slug, cat1-slug)"] - Custom post type, eg.:
[exopite-multifilter post_type="exopite-portfolio" thumbnail-size-single-row="blog-list-full" thumbnail-size-multi-row="blog-list-multiple" taxonomies_terms="exopite-portfolio-category, exopite-portfolio-tag"] [exopite-multifilter thumbnail-size-single-row="blog-list-full" thumbnail-size-multi-row="blog-list-multiple"]
Available options
| Options | Values | Defaults |
|---|---|---|
post_type |
['post-type-slug'] as post type slug | post |
post_status |
['post-status'] comma separated list | publish |
posts_per_page |
['number'] how many post per page per shortcode | 4 |
posts_per_row |
['1' - '4'] how many posts per row per shortcode | 2 |
display_title |
['true' or 'false'] display post title | false |
display_pagination |
['true' or 'false'] display pagination | true |
display_filter |
['true' or 'false'] display filter | true |
display_filter_title |
['true' or 'false'] display filter title | true |
blog_layout |
['top', 'left', 'right', 'zigzag' or 'none'] | top |
no-gap |
['true' or 'false'] hide gap between post | false |
except_lenght |
['number'] the lenght of the exceprt by words, '0' means no exceprt | 0 |
except_more |
['text'] excerpt more | |
pagination |
['pagination', 'readmore' or 'infinite'] the type of the pagination | pagination |
multi_selectable |
['true' or 'false'] single or multiselect: true or false | true |
thumbnail-size-single-row |
['thumbnail-size-slug'] thumbnail size for single post per row | full |
thumbnail-size-multi-row |
['thumbnail-size-slug'] thumbnail size for multipe post per row | large |
include_taxonomies |
['category, post_tag' or 'post_tag' etc...] display selected taxonomies | category |
taxonomy_terms__in |
['category(term1, terms2, ...)] display selected terms in taxonomy | |
in_all_taxnomies |
['true' or 'false'] If true, match all taxonomy queries (subtractive query), otherwise posts which match at least one taxonomy query (additive query) | true |
update_paged |
['true' or 'false'] Update page in browser URL bar on readmore and infinite loading based on viewport | false |
display_page_number |
['true' or 'false'] Show page number between loads in infinite and readmore | false |
paged |
['number'], Set start page number if not already paged | 1 |
effect |
['apollo', 'duke', 'goliath', 'julia', 'lexi', 'ming', 'steve' or none] | apollo |
search |
['search'] search in previously definied post type. If set, filter will be disabled. | |
load_from_url |
['true of false'] if set, plugin load filters, pagination or search from URL. Will override localstorage. Set container_id in shortcode is required to enable this option. Format need to be a JSON object, like: //www.exaple.net/?[...&]multifilter={"[container_id]":{"[taxonomy_terms__in]":{"[taxonomy1]":["term1[,...]"]},"paged":[page_number],"search":"[search_for]"}}, the [container_id] is required |
false |
store_session |
['true' or 'false'] Store current session (page number, selected filters and search). Useful if visitor is hit back or click on back button | false |
random |
['true' or 'false'] randomize query (pagination, filters and search are off) | false |
order |
['asc' or 'desc'] Designates the ascending or descending order of the 'orderby' parameter. | desc |
orderby |
['string' or 'string1|string2|...'] Sort retrieved posts by parameter. WordPress default is 'date (post_date)'. | |
display_metas |
['author', 'date', 'taxonomy', 'last-modified' or 'commentcount'] display meta on post item | |
display_metas_taxonomies |
only if display_metas has 'taxonomy', taxonomy name to display (eg. for posts: category, post_tag), string or comma separated list | |
container_id |
['string'], Set wrapper/container id | |
container_classes |
['string or a comma searated list'], Set wrapper/container class[es] | |
style |
['masonry', 'equal-height', carousel, timeline or empty] style | |
masonry_type |
['waterfall-kudago', 'masonry-desandro'], type of masonry | waterfall-kudago |
col_min_width |
['number'] in px, only for waterfall-kudago | 340 |
gallery_mode |
['true', 'false'] Galley mode. On thumbnail click, open images insted of post type single. Post without a thumbnail will be ignored. | false |
archive_mode |
['true', 'false'] Automatically deal with archives. Only for posts. (Random, search, filters and taxonomies_terms will be disabled; posts_per_page is set to WordPress setting) | false |
ajax_mode |
['true', 'false'] Possibility to turn off AJAX loading. (Filters are off, no infinite or readmore pagination) | true |
target_override |
['true', 'false'] Override target location. Use <!-- exopite-multifilter-external-link: custom (absolute/relative) url --> or <!-- exopite-multifilter-internal-link: custom (absolute/relative) url --> from content instead of the 'the_perlamink', on 'gallery_mode' this won't change image url. Open exopite-multifilter-external-link in new tab and display taxonomies without links. |
false |
post_in |
['post_id,post_id,...'] use post ids. Specify posts to retrieve. | |
post_not_in |
['post_id,post_id,...'] use post ids. Specify post NOT to retrieve. | |
date_from |
['2001-12-31'] iso date. Specify date to retrieve post AFTER. | |
date_to |
['2002-12-31'] iso date. Specify date to retrieve post BEFORE. | |
video |
[meta_field_name] get video url from video field name. Set poster to post thumbnail. If empty video url, post thumbnail will be displayed. | |
video-args |
['controls muted autoplay'] extra args to video tag. | controls muted |
autoplay |
['true', 'false'] carousel autoplay (only style="carousel"). | true |
arrows |
['true', 'false'] carousel display arrows (only style="carousel"). | true |
autoplay_speed |
['number'] carousel time to display each slide (only style="carousel"). | 300 |
infinite |
['true', 'false'] carousel infinite (loop) play (only style="carousel"). | true |
speed |
[1000] carousel slide changing speed (only style="carousel"). | 1000 |
pause_on_hover |
['true', 'false'] carousel paise play on mouse hover (only style="carousel"). | true |
dots |
['true', 'false'] carousel display dots (only style="carousel"). | true |
adaptive_height |
['true', 'false'] carousel adaptive height (only style="carousel"). | false |
mobile_first |
['true', 'false'] carousel mobile first (only style="carousel"). | false |
slides_per_row |
['number'] carousel slides per row (only style="carousel"). | 1 |
slides_to_show |
['number'] carousel slides to show (only style="carousel"). | 1 |
slides_to_scroll |
['number'] carousel to scroll per turn (only style="carousel"). | 1 |
use_transform |
['true', 'false'] carousel use css transition (only style="carousel"). | true |
meta_key |
['meta-key'] custom field key. | |
meta_value |
['meta-value'] custom field value. | |
timeline-sub-date |
[string/html] content under the timline date. | |
timeline-date-format |
['date-string'] date format, tag allowed, uses date_i18n. | 'j. F Y' |
timeline-sticky |
['true' or 'false'] make date sticky on scroll. | true |
HOOKS (FILTERS)
- exopite-multifilter-thumbnail-image-url
- exopite-multifilter-thumbnail-oembed-url
- exopite-multifilter-thumbnail-link-url
- exopite-multifilter-thumbnail-video_url
- exopite-multifilter-thumbnail-link-target
- exopite-multifilter-filter-taxonomy-name
- exopite-multifilter-article-thumbnail
- exopite-multifilter-article-link
- exopite-multifilter-article-link-target
- exopite-multifilter-article-wrapper-begin
- exopite-multifilter-article-wrapper-end
INSTALLATION
- Upload
exopite-multifilterto the/wp-content/plugins/exopite-multifilter/directory
OR
-
Install plugin from WordPress repository (not yet) -
Activate the plugin through the 'Plugins' menu in WordPress
REQUIREMENTS
Server
- WordPress 4.0+ (May work with earlier versions too)
- PHP 5.3+ (Required)
- jQuery 1.9.1+
Browsers
- Modern Browsers
- Firefox, Chrome, Safari, Opera, IE 10+
- Tested on Firefox, Chrome, Edge, IE 11
PLANNED
- On mobile 6 page number is too much -> how should be displayed?
- Add widget (useful for SiteOrigin Page Builder)
- Add to WordPress repo.
CHANGELOG
= 20201020 - 2020-10-20 =
- Fixed: Uncaught ReferenceError: changeBrowserUrl is not defined
- Fixed: Uncaught ReferenceError: isElementInViewport is not defined
= 20190711 - 2019-07-11 =
- Added: Post status
= 20190129 - 2019-01-29 =
- Added: display filter title.
- Added hooks (filters):
- exopite-multifilter-thumbnail-image-url
- exopite-multifilter-thumbnail-oembed-url
- exopite-multifilter-thumbnail-link-url
- exopite-multifilter-thumbnail-video_url
- exopite-multifilter-thumbnail-link-target
- exopite-multifilter-filter-taxonomy-name
- exopite-multifilter-article-thumbnail
- exopite-multifilter-article-link
- exopite-multifilter-article-link-target
- exopite-multifilter-article-wrapper-begin
- exopite-multifilter-article-wrapper-end
= 20180929 - 2018-09-29 =
- Added: oembed as thumbnail from post meta.
- Added: sticky date and subtitle for timeline.
= 20180923 - 2018-09-23 =
- Added: timeline style.
= 20180921 - 2018-09-21 =
- Added: taxonomy_terms__in, select posts only in selected terms in taxonomy
- Changed: IMPORTANT: taxonomies_terms to include_taxonomies, select posts in taxonomies, terms are not allowed
= 20180718 - 2018-07-18 =
- Fixed: PHP v7: string "true" || "false" is evaluated to TRUE everytime, thanks for Fires04 (GitHub)
= 20180712 - 2018-07-12 =
- Fixed: Plugin won't load (Fatal error), thanks for 0x4d0x44
= 20180509 - 2018-05-09 =
- Improvement: First display meta then title
- Fixed: Do not display meta list if empty
= 20180223 - 2018-02-23 =
- Added: order, orderby and meta_key
- Fixed: Slick carousel JavaScript type juggling
= 20180218 - 2018-02-18 =
- Fixed: some error for slider
= 20180216 - 2018-02-16 =
- Fixed: remove widget to avoid actiovation error
= 20180123 - 2018-01-23 =
- Added: meta_key and meta_value
= 20180121 - 2018-01-21 =
- Added: carousel mode
- Added: date query (from date and/or to date)
= 20180106 - 2018-01-06 =
- Added: post_in and post_not_in
= 20171204 - 2017-12-04 =
- Added: Target override. Override target location. Use
<!-- exopite-multifilter-internal-link: custom (absolute/relative) url -->from content instead of the 'the_perlamink'. - Added: On
<!-- exopite-multifilter-external-link: custom (absolute/relative) url -->open in new tab and taxonomies displayed without links.
= 20171101 - 2017-11-01 =
- Added: Target override. Override target location. Use from content instead of the 'the_perlamink'.
= 20171015 - 2017-10-15 =
- Added: Archive mode. Automatically deal with archives.
= 20171009 - 2017-10-09 =
- Added: Galley mode. On thumbnail click, open images insted of post/page. It will not display post/pages/etc... without a thumbnail.
= 20171005 - 2017-10-05 =
- Improvement: equal-height for columns (flex)
- Improvement: enqueue scripts and styles only if shortcode present (enqueue both in footer)
= 20171004 - 2017-10-04 =
- Added: style options for equal-height.
- Improvement: load plugin scripts and styles only if shortcode present
= 20171003 - 2017-10-03 =
- Added: can load filter, pagination or search from URL.
- Added: container_id option to set wrapper/container id.
- Added: container_classes option to set wrapper/container class/es.
= 20170930 - 2017-09-30 =
- Fixed: some effects css didn't showed up property
- Improvement: "display_pagination" is moved to pagination: none
= 20170923 - 2017-09-23 =
- Added: placeholder image if thumbnail does not exist
= 1.0.4 - 2017-07-18 =
- Added: options to choose between additive and subtractive query.
- Added: options to randomize query.
- Added: options to display meta.
- Added: AJAX nonce.
= 1.0.3 - 2017-03-21 =
- Added: update function (for private hosting).
This will be removed if plugin is submitted to WordPress repository. https://github.com/YahnisElsts/wp-update-server
= 1.0.2 - 2017-03-05 =
- Improvement: Automatic script and style versioning for local css and js files based on file time. https://www.doitwithwp.com/enqueue-scripts-styles-automatic-versioning/
= 1.0.1 - 2017-03-04 =
- Added: restore previous session (localstorage).
- Added: more filters.
= 1.0 =
- Initial release.
LICENSE DETAILS
The GPL license of Exopite Multifilter grants you the right to use, study, share (copy), modify and (re)distribute the software, as long as these license terms are retained.
DISCLAMER
NO WARRANTY OF ANY KIND! USE THIS SOFTWARES AND INFORMATIONS AT YOUR OWN RISK! READ DISCLAMER.TXT! License: GNU General Public License v3
