{"id":15434610,"url":"https://github.com/lloc/multisite-taxonomy-widget","last_synced_at":"2026-04-16T23:38:11.566Z","repository":{"id":6325116,"uuid":"7560292","full_name":"lloc/Multisite-Taxonomy-Widget","owner":"lloc","description":"List the latest posts of a specific taxonomy in the whole blog-network","archived":false,"fork":false,"pushed_at":"2024-10-12T09:26:35.000Z","size":186,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-10-18T08:54:33.056Z","etag":null,"topics":["custom-taxonomy","hacktoberfest","multisite","shortcode","taxonomy","widgets","wordpress","wordpress-plugin"],"latest_commit_sha":null,"homepage":"https://lloc.de","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"watsonbox/cv_template_2004","license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lloc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-01-11T13:33:19.000Z","updated_at":"2024-10-12T09:26:39.000Z","dependencies_parsed_at":"2024-10-20T14:44:26.907Z","dependency_job_id":null,"html_url":"https://github.com/lloc/Multisite-Taxonomy-Widget","commit_stats":{"total_commits":71,"total_committers":1,"mean_commits":71.0,"dds":0.0,"last_synced_commit":"c6f8bcef13882d48260d77aff69a59d3143cb3ec"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lloc%2FMultisite-Taxonomy-Widget","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lloc%2FMultisite-Taxonomy-Widget/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lloc%2FMultisite-Taxonomy-Widget/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lloc%2FMultisite-Taxonomy-Widget/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lloc","download_url":"https://codeload.github.com/lloc/Multisite-Taxonomy-Widget/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245978277,"owners_count":20703678,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["custom-taxonomy","hacktoberfest","multisite","shortcode","taxonomy","widgets","wordpress","wordpress-plugin"],"created_at":"2024-10-01T18:40:16.428Z","updated_at":"2026-04-16T23:38:11.548Z","avatar_url":"https://github.com/lloc.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Multisite Taxonomy Widget\n\nDisplay a **recent posts**-widget of all your posts in your blog-network which have a specific tag, category or any other built-in or custom taxonomy.\n\n[![codecov](https://codecov.io/gh/lloc/Multisite-Taxonomy-Widget/graph/badge.svg?token=829HP64ZBZ)](https://codecov.io/gh/lloc/Multisite-Taxonomy-Widget)\n\nThis plugin enhances WordPress multisites by displaying related posts across the network. It offers a widget, shortcode, and filters for flexible content surfacing.\n\n_Please keep in mind that the version of the Multisite Taxonomy Widget on GitHub is a work in progress._\n\n**Download the [latest stable version from the WordPress Plugin Directory](http://downloads.wordpress.org/plugin/multisite-taxonomy-widget.zip).**\n\nNeed help? Check out the [forum](http://wordpress.org/support/plugin/multisite-taxonomy-widget) first! If you find any bugs then I would very much like to [hear about the issue](https://github.com/lloc/Multisite-Taxonomy-Widget/issues).\n\n## Features\n\n- Query posts across your multisite network by taxonomy (core or custom) with an adjustable limit.\n- Expose the content via a widget or shortcode, each supporting thumbnails and custom markup.\n- Extend behaviour through WordPress-style filters without touching core plugin code.\n\n## Installation\n\n1. Download the zip from the WordPress directory or clone this repository.\n2. Install it into your `wp-content/plugins/` directory and activate it network-wide.\n3. Configure the widget or shortcode as described below.\n\n## Usage\n\n### Widget\n\nAfter activation you will find **Multisite Taxonomy** in _Appearance ▸ Widgets_ (`/wp-admin/widgets.php`).\n\n- Drag the widget into any sidebar.\n- Configure the available fields:\n  - **Title** — optional heading for the widget output.\n  - **Taxonomy** — taxonomy slug (e.g. `category`, `post_tag`, `product_category`).\n- **Term Slug** — the term slug to query against (`cool-post` when the term name is _Cool post_).\n  - **Limit** — maximum number of posts; set to `-1` to show all (not recommended for large sites).\n  - **Thumbnail** — positive pixel width to include thumbnails, or `0`/empty to hide them.\n\n### Shortcode\n\nUse the `[mtw_posts]` shortcode anywhere shortcodes are supported. Parameters mirror the widget settings.\n\n```text\n[mtw_posts taxonomy=\"category\" name=\"test\"]\n\n[mtw_posts taxonomy=\"post_tag\" name=\"featured\" thumbnail=\"0\"]\n\n[mtw_posts taxonomy=\"product_category\" name=\"test\" limit=\"5\"]\n```\n\n## Filters and Extensibility\n\nHook Description | Purpose\n---|---\n`mtw_formatelements_output_filter` | Override the list wrappers (`\u003cul\u003e`, `\u003cli\u003e`).\n`mtw_thumbnail_output_filter` | Customize thumbnail markup with access to the post object and args.\n`mtw_shortcode_output_filter` | Adjust the shortcode list item output.\n`mtw_widget_output_filter` | Adjust the widget list item output.\n\n## Development\n\n```bash\ncomposer install        # install dependencies\ncomposer test           # run the PHPUnit suite with Brain Monkey\ncomposer phpstan        # static analysis using WordPress extensions\ncomposer coverage       # generate HTML coverage at tests/coverage/\n```\n\nFeel free to open pull requests; see `AGENTS.md` for the full contributor guide.\n\n## Support\n\nVisit the [support forum](http://wordpress.org/support/plugin/multisite-taxonomy-widget) to share questions or ideas. Bug reports are always welcome through [GitHub issues](https://github.com/lloc/Multisite-Taxonomy-Widget/issues).\n\nAdditional usage documentation and API references are available on the [project site](http://lloc.github.com/Multisite-Taxonomy-Widget/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flloc%2Fmultisite-taxonomy-widget","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flloc%2Fmultisite-taxonomy-widget","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flloc%2Fmultisite-taxonomy-widget/lists"}