{"id":22964720,"url":"https://github.com/devaloka/network-wp-query","last_synced_at":"2025-08-13T08:31:55.769Z","repository":{"id":53979192,"uuid":"48854918","full_name":"devaloka/network-wp-query","owner":"devaloka","description":":electric_plug: Network-wide WP Query for Multisite environment, which supports POSTS-PER-SITE query etc. [STAND-ALONE][Plugin]","archived":false,"fork":false,"pushed_at":"2020-08-20T21:41:34.000Z","size":49,"stargazers_count":16,"open_issues_count":6,"forks_count":2,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-11-24T09:42:40.384Z","etag":null,"topics":["multisite","network","plugin","wordpress","wp-query"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devaloka.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-12-31T16:11:29.000Z","updated_at":"2023-05-06T18:06:00.000Z","dependencies_parsed_at":"2022-08-13T05:40:31.312Z","dependency_job_id":null,"html_url":"https://github.com/devaloka/network-wp-query","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devaloka%2Fnetwork-wp-query","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devaloka%2Fnetwork-wp-query/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devaloka%2Fnetwork-wp-query/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devaloka%2Fnetwork-wp-query/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devaloka","download_url":"https://codeload.github.com/devaloka/network-wp-query/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229749313,"owners_count":18118325,"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":["multisite","network","plugin","wordpress","wp-query"],"created_at":"2024-12-14T20:12:09.359Z","updated_at":"2024-12-14T20:12:10.371Z","avatar_url":"https://github.com/devaloka.png","language":"PHP","readme":"# Network WP Query\n\n[![Latest Stable Version][stable-image]][stable-url]\n[![Latest Unstable Version][unstable-image]][unstable-url]\n[![License][license-image]][license-url]\n[![Build Status][travis-image]][travis-url]\n\nA WordPress plugin that provides Network-wide WP_Query for Multisite\nenvironment.\n\nThis plugin is based on / a improved version of [WP_Query_Multisite](https://github.com/miguelpeixe/WP_Query_Multisite)\n(a custom version of [WP_Query_Multisite](https://github.com/ericandrewlewis/WP_Query_Multisite)).\n\n## Installation\n\n### Manual Installation\n\n1.  Just copy all files into `\u003cABSPATH\u003ewp-content/plugins/network-wp-query/`.\n\n### Manual Installation (as a Must-Use plugin)\n\n1.  Just copy all files into `\u003cABSPATH\u003ewp-content/mu-plugins/network-wp-query/`.\n\n2.  Move `network-wp-query/loader/50-network-wp-query-loader.php`\n    into `\u003cABSPATH\u003ewp-content/mu-plugins/`.\n\n### Installation via Composer\n\n1.  Install via Composer.\n\n    ```sh\n    composer require devaloka/network-wp-query\n    ```\n\n### Installation via Composer (as a Must-Use plugin)\n\n1.  Install via Composer.\n\n    ```sh\n    composer require devaloka/network-wp-query\n    ```\n\n2.  Move `network-wp-query` directory into\n    `\u003cABSPATH\u003ewp-content/mu-plugins/`.\n\n3.  Move `network-wp-query/loader/50-network-wp-query-loader.php`\n    into `\u003cABSPATH\u003ewp-content/mu-plugins/`.\n\n## Example Usage\n\n### Standard Loop\n\n```php\n\u003c?php $query = new WP_Query(['network' =\u003e true]); ?\u003e\n\n\u003c?php if ($query-\u003ehave_posts()): ?\u003e\n    \u003c?php while ($query-\u003ehave_posts()): $query-\u003ethe_post(); ?\u003e\n        \u003c?php the_content(); ?\u003e\n    \u003c?php endwhile; ?\u003e\n\n    \u003c?php wp_reset_postdata(); ?\u003e\n\u003c?php endif; ?\u003e\n```\n\n### Query to several specific Sites\n\n```php\n\u003c?php $query = new WP_Query(['network' =\u003e true, 'sites__in' =\u003e [1, 2, 3]]); ?\u003e\n\n\u003c?php if ($query-\u003ehave_posts()): ?\u003e\n    \u003c?php while ($query-\u003ehave_posts()): $query-\u003ethe_post(); ?\u003e\n        \u003c?php the_content(); ?\u003e\n    \u003c?php endwhile; ?\u003e\n\n    \u003c?php wp_reset_postdata(); ?\u003e\n\u003c?php endif; ?\u003e\n```\n\n### Query excluding several specific Sites\n\n```php\n\u003c?php $query = new WP_Query(['network' =\u003e true, 'sites__not_in' =\u003e [1, 2, 3]]); ?\u003e\n\n\u003c?php if ($query-\u003ehave_posts()): ?\u003e\n    \u003c?php while ($query-\u003ehave_posts()): $query-\u003ethe_post(); ?\u003e\n        \u003c?php the_content(); ?\u003e\n    \u003c?php endwhile; ?\u003e\n\n    \u003c?php wp_reset_postdata(); ?\u003e\n\u003c?php endif; ?\u003e\n```\n\n### Limit the number of posts per Site\n\n```php\n\u003c?php $query = new WP_Query(['network' =\u003e true, 'posts_per_site' =\u003e 1]); ?\u003e\n\n\u003c?php if ($query-\u003ehave_posts()): ?\u003e\n    \u003c?php while ($query-\u003ehave_posts()): $query-\u003ethe_post(); ?\u003e\n        \u003c?php the_content(); ?\u003e\n    \u003c?php endwhile; ?\u003e\n\n    \u003c?php wp_reset_postdata(); ?\u003e\n\u003c?php endif; ?\u003e\n```\n\n## Parameters\n\n| Name           |  Type   | Description                               |\n|----------------|:-------:|-------------------------------------------|\n| network        | boolint | Whether perform network-wide query.       |\n| sites__in      | int[]   | Blog IDs to include in the query.         |\n| sites__not_in  | int[]   | Blog IDs to excluded from the query.      |\n| posts_per_site | int     | The number of posts per Site to retrieve. |\n\n## References\n\n*   [ericandrewlewis/WP_Query_Multisite](https://github.com/ericandrewlewis/WP_Query_Multisite)\n*   [miguelpeixe/WP_Query_Multisite](https://github.com/miguelpeixe/WP_Query_Multisite)\n*   [#22816 (Multisite WP_Query) – WordPress Trac](https://core.trac.wordpress.org/ticket/22816)\n\n[stable-image]: https://poser.pugx.org/devaloka/network-wp-query/v/stable\n[stable-url]: https://packagist.org/packages/devaloka/network-wp-query\n\n[unstable-image]: https://poser.pugx.org/devaloka/network-wp-query/v/unstable\n[unstable-url]: https://packagist.org/packages/devaloka/network-wp-query\n\n[license-image]: https://poser.pugx.org/devaloka/network-wp-query/license\n[license-url]: https://packagist.org/packages/devaloka/network-wp-query\n\n[travis-image]: https://travis-ci.org/devaloka/network-wp-query.svg?branch=master\n[travis-url]: https://travis-ci.org/devaloka/network-wp-query\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevaloka%2Fnetwork-wp-query","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevaloka%2Fnetwork-wp-query","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevaloka%2Fnetwork-wp-query/lists"}