{"id":70467,"date":"2017-06-16T11:33:38","date_gmt":"2017-06-16T11:33:38","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/itsisotope\/"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-30T00:00:00","slug":"itsisotope","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/itsisotope\/","author":15211634,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"2.2","stable_tag":"2.1","tested":"4.2.39","requires":"3.5.1","requires_php":"","requires_plugins":"","header_name":"itsIsotope","header_author":"itsRashad","header_description":"itsIsotope is the wordpress plugins for Metafizzy's Isotope to display feeds of WordPress posts using simple shortcodes. Works with custom post types and custom taxonomies too.","assets_banners_color":"","last_updated":"2017-06-16 11:33:38","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/itsisotope\/","header_author_uri":"http:\/\/itsrashad.info","rating":0,"author_block_rating":0,"active_installs":0,"downloads":1652,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":[],"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":[],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"List of saved Isotope Post shortcodes","2":"itsIsotope settings modal","3":"Sample of featured image and excerpt output"}},"plugin_section":[],"plugin_tags":[],"plugin_category":[],"plugin_contributors":[],"plugin_business_model":[],"class_list":["post-70467","plugin","type-plugin","status-closed","hentry","plugin_committers-itsrashad"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/itsisotope.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"\n\n<!--section=description-->\n<p>itsIsotope is a simple WordPress implementation of Metafizzy's javascript Isotope plugin. Use the plugin settings page to customize Isotope options and create loops of WordPress posts, then implement them on your site using simple shortcodes. Magic.<\/p>\n\n<p>Some features:<\/p>\n\n<ul>\n<li>No need to muck around with javascript or theme files \u2013 implement Isotope directly in the WordPress editor with a simple shortcode!<\/li>\n<li>Includes essential Isotope features, including the option for a filter menu, sorting options, and layout options<\/li>\n<li>Hide posts from displaying based on category, post tag, or custom taxonomy terms<\/li>\n<li>Grab the post's featured image include with the excerpt (if one is set)<\/li>\n<li>Minimal included css makes it easier to customize the look and feel of the loop output for your site<\/li>\n<\/ul>\n\n<p><strong>New in v2<\/strong><\/p>\n\n<ul>\n<li>Create and save as many Isotope shortcodes as you want to use on multiple pages throughout your site<\/li>\n<li>Paginate your loop of posts using infinite scrolling (rather than loading them all at once)<\/li>\n<li>Now uses v2 of the javascript Isotope plugin<\/li>\n<li>Plays nice with WordPress Multisite<\/li>\n<\/ul>\n\n<h4>Are you upgrading from v1.X?<\/h4>\n\n<p>If you're upgrading to v2+ of itsIsotope from v1.X, you'll need to run the <a href=\"https:\/\/github.com\/mandiwise\/itsisotope-migrator\">itsIsotope v2 Migrator plugin<\/a> first. Be sure to deactivate and delete the migrator plugin before attempting to re-activate of itsIsotope.<\/p>\n\n<h4>A note re: licensing:<\/h4>\n\n<p>Metafizzy's javascript Isotope plugin is licensed under MIT and free to use for non-commercial, personal, open-source projects only. Find out more about <a href=\"http:\/\/isotope.metafizzy.co\/license.html\">commercial licensing<\/a> if you plan on using this plugin for commercial purposes.<\/p>\n\n<h3>Credit Roll<\/h3>\n\n<ul>\n<li>Tom McFarlin's time-saving <a href=\"https:\/\/github.com\/tommcfarlin\/WordPress-Plugin-Boilerplate\">WordPress Plugin Boilerplate<\/a>. Why start from scratch when you don't have to?<\/li>\n<li>David DeSandro's (Metafizzy) <a href=\"http:\/\/isotope.metafizzy.co\/index.html\">Isotope<\/a> jQuery plugin. Minimum js input, maximum interactive fun.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Extract the <code>itsisotope.zip<\/code> and remove <code>-master<\/code> from the extracted directory name<\/li>\n<li>Upload the <code>itsisotope<\/code> folder and its contents to the <code>\/wp-content\/plugins\/<\/code> directory<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<li>Go to the Settings &gt; itsIsotope page and adjust the settings as needed.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt>Installation Instructions<\/dt>\n<dd><ol>\n<li>Extract the <code>itsisotope.zip<\/code> and remove <code>-master<\/code> from the extracted directory name<\/li>\n<li>Upload the <code>itsisotope<\/code> folder and its contents to the <code>\/wp-content\/plugins\/<\/code> directory<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<li>Go to the Settings &gt; itsIsotope page and adjust the settings as needed.<\/li>\n<\/ol><\/dd>\n<dt>How do I make this thing work in my theme?<\/dt>\n<dd><p>To implement itsIsotope on your site, simply head over to the itsIsotope settings page in your WordPress admin area, create a loop of posts with your preferred options and then save it. Next, grab the unique shortcode for the loop you just saved (e.g. <code>[itsisotope id=\"YOUR_UNIQUE_ID\"]<\/code>) and embed it in a page in your site.<\/p><\/dd>\n<dt>How do I make this thing work in a template file?<\/dt>\n<dd><p>You can use <code>do_shortcode<\/code> to directly embed an itsIsotope loop in a template file (instead of pasting it into the WYSIWYG editor for a given page on your site).<\/p>\n\n<p>However, in order to ensure that the itsIsotope plugin has the smallest possible footprint on your site, the plugin only loads the required Isotope CSS file on pages where it finds an itsIsotope shortcode inside <code>the_content<\/code> (i.e. embedded in the WYSIWYG editor). In order to manually add the required CSS when you use <code>do_shortcode<\/code> within your theme files, set an additional attribute on your shortcode as follows:<\/p>\n\n<pre><code>[itsisotope id=\"YOUR_UNIQUE_ID\" load_css=\"true\"]\n<\/code><\/pre>\n\n<p><strong>NOTE:<\/strong> You do NOT need to add the <code>load_css<\/code> attribute to your shortcode if you are simply pasting it into a page's WYSIWYG editor.<\/p><\/dd>\n<dt>What kind of Isotope options are available?<\/dt>\n<dd><p>itsIsotope takes advantage of a number of the original javascript plugins's options. On the plugin settings page you have the option to:<\/p>\n\n<ul>\n<li>Add a filter menu (based on post categories or tags, or a custom taxonomy)<\/li>\n<li>Arrange your posts descending by date or ascending alphabetically by title<\/li>\n<li>Choose whether to use display evenly in horizontal rows or masonry-style<\/li>\n<li>Add pagination to your posts using infinite scrolling<\/li>\n<\/ul><\/dd>\n<dt>Does this plugin work with custom post types and taxonomies?<\/dt>\n<dd><p>Absolutely. To use a custom post type, simply pick it from the select menu on the plugin settings page. Same goes for using a custom taxonomy for a filter menu.<\/p><\/dd>\n<dt>Why do things get weird when I try to add a filter menu and use infinite scrolling?<\/dt>\n<dd><p>As the author of the javascript Isotope plugin has pointed out in the past, using infinite scrolling with filtering can create a very odd user experience and you probably want to avoid doing this.<\/p>\n\n<p>In my experience, the only time that using filters with infinite scrolling isn't completely weird is when you have a lot of posts in your selected post type AND the terms for the taxonomy you use to create your filter menu are more or less evenly spread across your posts. If you must go down this road, please be sure to test this thoroughly before you unleash it on your users.<\/p><\/dd>\n<dt>Why does the plugin break when I try to add two itsIsotope shortcodes on one page?<\/dt>\n<dd><p>Play it safe. While you can implement multiple itsIsotope shortcodes throughout your site, you'll only want to add one at a time on any given page. Things go a little bit sideways in the javascript when you try to load two itsIsotope shortcodes on a single page.<\/p><\/dd>\n<dt>Is it localized?<\/dt>\n<dd><p>Yes, but no translations are available quite yet.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2.1<\/h4>\n\n<ul>\n<li>Add <code>before_isotope_title<\/code>, <code>before_isotope_content<\/code>, and <code>after_isotope_content<\/code> action hooks to allow customization of Isotope item content.<\/li>\n<li>Improve responsiveness of admin settings lightbox.<\/li>\n<li>Localize additional strings.<\/li>\n<\/ul>\n\n<h4>2.0.9<\/h4>\n\n<ul>\n<li>Fix bug where clicking the \"See All\" filter would jump the browser to the top of the page.<\/li>\n<\/ul>\n\n<h4>2.0.8<\/h4>\n\n<ul>\n<li>Fix filter menu so that it doesn't show excluded terms when the filter menu taxonomy is the same as the limiting taxonomy (again)<\/li>\n<\/ul>\n\n<h4>2.0.7<\/h4>\n\n<ul>\n<li>Adjust pre-filling behaviour when using filtering and infinite scrolling together (even though this is not advisable) to address JS errors<\/li>\n<li>Remove old Isotope js file<\/li>\n<li>Update Isotope library to 2.0.1<\/li>\n<\/ul>\n\n<h4>2.0.6<\/h4>\n\n<ul>\n<li>Fix pagination bug when implementing a loop on a static homepage<\/li>\n<\/ul>\n\n<h4>2.0.5<\/h4>\n\n<ul>\n<li>Add check on post elements when a filter menu has been added but the post doesn't have any taxonomy terms assigned (props <a href=\"https:\/\/github.com\/crondeau\">@crondeau<\/a>)<\/li>\n<\/ul>\n\n<h4>2.0.4<\/h4>\n\n<ul>\n<li>Add ability to manually load public CSS when using <code>do_shortcode<\/code><\/li>\n<li>Improve responsiveness of public CSS<\/li>\n<\/ul>\n\n<h4>2.0.3<\/h4>\n\n<ul>\n<li>Ensure scripts and styles only load when the shortcode is present (for real this time...)<\/li>\n<\/ul>\n\n<h4>2.0.2<\/h4>\n\n<ul>\n<li>Fixed issue with settings array saving incorrectly when plugin options did not exist yet<\/li>\n<li>Remove automatic activation for new blogs in multisite<\/li>\n<\/ul>\n\n<h4>2.0.1<\/h4>\n\n<ul>\n<li>Fixed fatal error on activation<\/li>\n<\/ul>\n\n<h4>2.0<\/h4>\n\n<ul>\n<li>Refactored all plugin code<\/li>\n<li>Revamped the plugin settings page to allow users to save multiple post loops (this is a breaking change)<\/li>\n<li>Add ability to paginate posts using infinite scroll<\/li>\n<\/ul>\n\n<h4>1.1.3<\/h4>\n\n<ul>\n<li>Made taxonomy classes conditional on loop items to stop php warning when not using a filter menu (props <a href=\"https:\/\/github.com\/jengalas\">@jengalas<\/a>).<\/li>\n<\/ul>\n\n<h4>1.1.2<\/h4>\n\n<ul>\n<li>Added else condition to handle post loop with no results<\/li>\n<li>Updated call to admin.js file so it only loads where needed<\/li>\n<\/ul>\n\n<h4>1.1.1<\/h4>\n\n<ul>\n<li>Fixed bug when trying to filter post display by category or post tag.<\/li>\n<li>Changed filter menu to automatically remove user-excluded terms if the selected menu taxonomy is the same as the limiting taxonomy.<\/li>\n<li>Reversed \"Limiting Taxonomy\" logic so that entered terms slugs are excluded from display (as opposed to the only terms displayed).<\/li>\n<li>More code refactoring.<\/li>\n<\/ul>\n\n<h4>1.1<\/h4>\n\n<ul>\n<li>Added ability to limit post display to specific taxonomy and terms.<\/li>\n<li>Light code refactoring.<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>Initial plugin release.<\/li>\n<\/ul>","raw_excerpt":"itsIsotope is the wordpress plugins for Metafizzy's Isotope to display feeds of WordPress posts using simple shortcodes. Works with custom post types and custom taxonomies too.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/70467","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=70467"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/itsrashad"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=70467"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=70467"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=70467"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=70467"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=70467"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=70467"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}