Title: Sparrow Portfolio Author: madsparrow Published: October 27, 2026 Last modified: October 27, 2026 --- Search plugins ![](https://ps.w.org/sparrow-portfolio/assets/banner-772x250.png?rev=3768240) ![](https://ps.w.org/sparrow-portfolio/assets/icon.svg?rev=3768334) # Sparrow Portfolio By [madsparrow](https://profiles.wordpress.org/madsparrow/) [Download](https://downloads.wordpress.org/plugin/sparrow-portfolio.1.0.0.zip) * [Details](https://wordpress.org/plugins/sparrow-portfolio/#description) * [Reviews](https://wordpress.org/plugins/sparrow-portfolio/#reviews) * [Installation](https://wordpress.org/plugins/sparrow-portfolio/#installation) * [Development](https://wordpress.org/plugins/sparrow-portfolio/#developers) [Support](https://wordpress.org/support/plugin/sparrow-portfolio/) ## Description Sparrow Portfolio adds a dedicated “Portfolio” custom post type and category taxonomy to WordPress, so you can showcase your projects independently of any page builder. It works entirely on its own with the built-in Gutenberg block, or alongside the Sparrow Elementor Widgets plugin for Elementor-based layouts — both share the same portfolio content, so you only manage it once. **🖼️ Four Layout Types** Grid, List, Masonry, or Carousel — switch between them from one panel without rebuilding your page. The Carousel layout runs on Swiper with configurable loop, autoplay, speed, mousewheel control, and centered slides. **🎯 Flexible Content Source** Show all projects, filter by a single category or author, or hand-pick specific projects one by one with a searchable picker. Order by date, title, menu order, or random, in either direction. **️ Drag & Drop Ordering** Reorder projects by dragging them right in the Portfolio list — the new order is saved instantly, no extra plugin needed. Set the block to order by menu order and the grid follows it. **🔍 AJAX Filter & Sort** A category filter and a sort control, each switchable between an inline list or a dropdown select, with the position of the two fully configurable — left, right, center, or split to opposite edges (with a one-click Swap Sides). Everything updates over AJAX, no page reload. **🔎 Instant Project Search** A search button that opens a dropdown with live results as you type — thumbnail, title with the matched part highlighted, and category. The list of projects is loaded once and filtered in the browser, so typing never hits the database. Place it above, below, or inline with the filter and sorting, or anywhere on the site with the `[ sparrow_portfolio_search]` shortcode. **🎨 Three Matching Visual Styles** Filter, sorting and pagination all ship with the same three styles — Underline Tabs, Filter Chips, and Outlined Buttons — so you can set them to match for a single, consistent design across the block. **📄 Numbers or Load More Pagination** Classic numbered pagination or a Load More button, both AJAX-powered, with configurable alignment and button text. **✍️ Full Typography Control** Independent color, font size (with a px / % / em / rem / vw / custom unit picker), font family (from a built-in list of Google Fonts), and weight for the title, category, and date — plus where the date sits, how it’s separated, and whether a divider shows in the List layout. **✨ Hover Effects** Built-in hover effects for thumbnails — zoom in, zoom out, grayscale to color, color to grayscale, and darken. **🎬 Featured Video Support** Attach a video to any project and choose whether it autoplays or only plays on hover, right on the grid thumbnail — no popup required. **🧩 Text Position** Place the title, category and date below the thumbnail, above it, or on top of the image as a color-tinted overlay with a 9-point alignment picker — with text alignment, title/meta gap and padding controls. **🖱️ Click-to-Edit Preview** Hover over any part of the portfolio right in the editor — title, category, date, thumbnail, filter, search or pagination — to see it outlined, then click to jump straight to its settings. No hunting through panels. **📱 Responsive Controls** Columns, gaps, font sizes, letter spacing, padding, corner radius, thumbnail aspect ratio and text alignment can each be set separately for desktop, tablet and mobile. Pick the device next to a setting and the editor preview switches with it; an empty tablet or mobile value simply follows the larger screen. **➡️ Project Navigation** Previous / Next navigation on the project page in four styles — button group, arrows, titles, or cards with thumbnails. It steps through projects by date or in your drag- and-drop order, can stay inside the current category, can loop, and its middle button takes the visitor back to the grid they came from. **🔒 Password-Protected Projects** Protect a project with the standard WordPress password and visitors get a clean, theme-independent password form with a show/hide toggle, an “incorrect password” message, and an optional “Contact the author” link. Protected projects are marked with a lock badge in the grid. **🌗 Dark Mode** Switch the filter, sorting, search and pagination to a dark color scheme — always, by the visitor’s system setting, or in sync with your theme’s own light/dark switch( just enter the class or attribute your theme uses). Title, category and date can have separate colors for light and dark. **⚙️ Settings Page** Portfolio Settings: URL bases for projects and categories, the portfolio page, your own names for the post type (“Works”, “Cases”…), a placeholder image for projects without a featured image, navigation and password form options, color scheme, and locally hosted fonts. **🛠️ Shortcode** An auto-generated, always-in-sync shortcode so the same design can be dropped into Elementor, the classic editor, or any theme template. **🎭 Theme-Overridable Templates** Ships its own single and archive templates for classic themes so it works out of the box, and uses the theme’s own templates on block themes. A theme can override either one by simply providing its own `archive-portfolios.php` or `single-portfolios. php` — no filters or hooks required. ### External services This plugin can load fonts from Google Fonts, a font delivery service provided by Google. It is used only when you pick a font family for the project title, category or date in the block settings. In that case, each time a page with that block is displayed, the visitor’s browser requests the font stylesheet from `fonts.googleapis.com` and the font files from `fonts.gstatic.com`. As with any web request, the visitor’s IP address and browser details are sent to Google. No other data is sent. If you enable “Load Google Fonts locally” in Portfolio Settings Performance, your server downloads the font files once and serves them from your own site; visitors’ browsers then make no requests to Google. * Terms of service: https://developers.google.com/fonts/terms * Privacy policy: https://policies.google.com/privacy ### Source code The block’s scripts and styles in the `build/` folder are compiled with `@wordpress/ scripts`. Their readable source is included in the plugin, in the `src/` folder. To rebuild them, run `npm install` and then `npm run build` in the plugin folder. The scripts in `assets/js/` and the styles in `assets/css/` are not compiled; they ship as readable, unminified source. ## Screenshots [⌊Grid, Masonry, List and Carousel layouts with filter and search.⌉⌊Grid, Masonry, List and Carousel layouts with filter and search.⌉[ Grid, Masonry, List and Carousel layouts with filter and search. [⌊Click-to-Edit Preview: hover any element in the editor and click to jump straight to its settings.⌉⌊Click-to-Edit Preview: hover any element in the editor and click to jump straight to its settings.⌉[ Click-to-Edit Preview: hover any element in the editor and click to jump straight to its settings. [⌊Block settings: content, layout, toolbar and pagination.⌉⌊Block settings: content, layout, toolbar and pagination.⌉[ Block settings: content, layout, toolbar and pagination. [⌊AJAX filtering and pagination: browse projects without reloading the page.⌉⌊AJAX filtering and pagination: browse projects without reloading the page.⌉[ AJAX filtering and pagination: browse projects without reloading the page. [⌊Search dropdown with live results.⌉⌊Search dropdown with live results.⌉[ Search dropdown with live results. [⌊Project page navigation styles.⌉⌊Project page navigation styles.⌉[ Project page navigation styles. [⌊Password form for protected projects.⌉⌊Password form for protected projects.⌉[ Password form for protected projects. [⌊Plugin settings page.⌉⌊Plugin settings page.⌉[ Plugin settings page. ## Blocks This plugin provides 1 block. * Sparrow Portfolio Display your portfolio projects in a grid. ## Installation 1. Upload the `sparrow-portfolio` folder to the `/wp-content/plugins/` directory, or install the plugin through the WordPress plugins screen directly. 2. Activate the plugin through the ‘Plugins’ screen in WordPress. 3. Add and manage your projects under the new “Portfolio” menu item. 4. Add the “Sparrow Portfolio” block to any page to display them. ## FAQ ### Does it work with any theme? Yes. The block brings its own styles and works with classic and block themes. On classic themes the plugin provides simple single and archive templates; on block themes your theme’s own templates are used. ### How do I change the “portfolio” part of the URL? Go to Portfolio Settings General. You can set the base for project URLs and for category pages, and choose which page is your main portfolio page. ### Can I protect a project with a password? Yes. Set the project’s visibility to “Password protected” in the editor. Visitors see the plugin’s own password form, and the project shows a lock badge in the grid. ### How does dark mode work with my theme’s light/dark switch? Go to Portfolio Settings Color Scheme, choose “Follow the theme” and enter the class or attribute your theme adds to the page in dark mode, for example `.dark- theme` or `[data-theme="dark"]`. The portfolio controls switch together with your theme, without a page reload. ### Does the plugin load anything from external servers? Only if you choose a Google font for the title, category or date in the block. See“ External services” below. You can also turn on “Load Google Fonts locally” in Portfolio Settings Performance, and the font files are then served from your own site. ### Where do I put the search button outside the portfolio block? Use the `[sparrow_portfolio_search]` shortcode in a Shortcode block, a widget, or your theme’s header. If it sits in the header, turn on “Load on every page” in Portfolio Settings General Search. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Sparrow Portfolio” is open source software. The following people have contributed to this plugin. Contributors * [ madsparrow ](https://profiles.wordpress.org/madsparrow/) [Translate “Sparrow Portfolio” into your language.](https://translate.wordpress.org/projects/wp-plugins/sparrow-portfolio) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/sparrow-portfolio/), check out the [SVN repository](https://plugins.svn.wordpress.org/sparrow-portfolio/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/sparrow-portfolio/) by [RSS](https://plugins.trac.wordpress.org/log/sparrow-portfolio/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.0 * Initial release. ## Meta * Version **1.0.0** * Last updated **4 days ago** * Active installations **Fewer than 10** * WordPress version ** 6.8 or higher ** * Tested up to **7.1.4** * PHP version ** 8.0 or higher ** * Tags * [filterable portfolio](https://wordpress.org/plugins/tags/filterable-portfolio/) [gallery](https://wordpress.org/plugins/tags/gallery/)[masonry](https://wordpress.org/plugins/tags/masonry/) [portfolio](https://wordpress.org/plugins/tags/portfolio/)[portfolio grid](https://wordpress.org/plugins/tags/portfolio-grid/) * [Advanced View](https://wordpress.org/plugins/sparrow-portfolio/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/sparrow-portfolio/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/sparrow-portfolio/reviews/) ## Contributors * [ madsparrow ](https://profiles.wordpress.org/madsparrow/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/sparrow-portfolio/)