{"id":15434610,"url":"https://github.com/lloc/multisite-taxonomy-widget","last_synced_at":"2025-03-28T06:12:32.544Z","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":"2025-03-28T06:12:32.514Z","avatar_url":"https://github.com/lloc.png","language":"PHP","readme":"Multisite Taxonomy Widget\n=========================\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\n_Please keep in mind that the version of the Multisite Taxonomy Widget at 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\nHow to use the widget\n---------------------\n\nAfter the activation of the plugin you'll find a new widget called Multisite Taxonomy in _Appearance \u003e Widgets_ (/wp-admin/widgets.php).\n\nOnce you dragged the widget in one of your sidebars you can fill in various parameters for customizing the output of the widget:\n\n1.  **Title**\n\n\tThis is the widget title. Leave it empty if you don't need to show a title above the widget.\n\n2.  **Taxonomy**\n\n\tThis is the type of the taxonomy such as category, tag and so on.\n\n3.  **Name**\n\n\tThis is the most important parameter. If you want the widget to search for all posts with the tag _Cool post_ for example put _cool-post_ in here because the plugin uses the slug-form of the taxonomies and the slug of the _Cool post_-taxonomy is probably saved as _cool-post_. But you should check that anyway.\n\n4.  **Limit**\n\n\tYou can limit the output with this parameter. This should be a number \u003e 0. If you want to show all posts of the specific taxonomy you can set -1 but it is not recommended. \n\n5.  **Thumbnail**\n\n\tYou can set any positive number here if you want to show thumbnails. If you don't like them leave this field empty or fill in a 0.\n\nHow to use the shortcode\n------------------------\n\nUse the shortcode _[mtw_posts]_ if you'd like to show a list of posts of your network in the content where usually a normal widget cannot be placed. The parameters are similar to those for the widget. You can use taxonomy, name, limit and thumbnail as arguments.\n\nWith this in mind you can write\n\n\t[mtw_posts taxonomy=\"category\" name=\"test\"]\n\nif you want to show the last 10 (because this is standard when limit is not set) posts in the category test. If you prefer tags and you don't want to see thumbnails use:\n\n\t[mtw_posts taxonomy=\"post_tag\" name=\"test\" thumbnail=\"0\"]\n\nAnd if you want to show the last 5 posts of a post type which has a custom taxonomy called product_category, you could use something like:\n\n\t[mtw_posts taxonomy=\"product_category\" name=\"test\" limit=\"5\"]\n\nHow to use the filter hooks\n---------------------------\n\nYou can use filters if you want to override the output of the functions. The are 4 filters available:\n\n1.  **mtw_formatelements_output_filter**\n\n\tThere is a function which calls this filter after adding 4 elements to an array of format-elements: before_mtw_list/after_mtw_list (`\u003cul\u003e/\u003c/ul\u003e`) and before_mtw_item/after_mtw_item (`\u003cli\u003e/\u003c/li\u003e`) so you can override this.\n\n\t[See also](http://lloc.github.com/Multisite-Taxonomy-Widget/function-mtw_get_formatelements.html)\n\n2.  **mtw_thumbnail_output_filter**\n\n\tYou can create your customized output of the thumbnail. This filter gives you access to a post-object and an array of parameters and returns the string from your function if you define one.\n\n\t[See also](http://lloc.github.com/Multisite-Taxonomy-Widget/function-mtw_get_thumbnail.html)\n\n3.  **mtw_shortcode_output_filter**\n\n\tYou can create your customized output of the list-item when a shortcode is used. This filter gives you access to a post-object and an array of parameters and returns the string from your function if you define one.\n\n\t[See also](http://lloc.github.com/Multisite-Taxonomy-Widget/function-mtw_create_shortcode.html)\n\n4.  **mtw_widget_output_filter**\n\n\tYou can create your customized output of the list-item when a widget is used. This filter gives you access to a post-object and an array of parameters and returns the string from your function if you define one.\n\n\t[See also](http://lloc.github.com/Multisite-Taxonomy-Widget/class-MultisiteTaxonomyWidget.html)\n","funding_links":[],"categories":[],"sub_categories":[],"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"}