PHPackages                             alleyinteractive/archiveless - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. alleyinteractive/archiveless

ActiveWordpress-plugin[Utility & Helpers](/categories/utility)

alleyinteractive/archiveless
============================

WordPress plugin to hide posts from archives (lists)

v1.2.0(6mo ago)810.4k↓11.1%2[1 issues](https://github.com/alleyinteractive/archiveless/issues)[12 PRs](https://github.com/alleyinteractive/archiveless/pulls)GPL-3.0-or-laterPHPPHP >=8.2CI passing

Since Aug 24Pushed 3mo ago36 watchersCompare

[ Source](https://github.com/alleyinteractive/archiveless)[ Packagist](https://packagist.org/packages/alleyinteractive/archiveless)[ Docs](https://github.com/alleyinteractive/archiveless)[ RSS](/packages/alleyinteractive-archiveless/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (4)Dependencies (2)Versions (20)Used By (0)

Archiveless
===========

[](#archiveless)

[![Testing Suite](https://github.com/alleyinteractive/archiveless/actions/workflows/all-pr-tests.yml/badge.svg?branch=develop)](https://github.com/alleyinteractive/create-wordpress-plugin/actions/workflows/all-pr-tests.yml)

Excludes specific WordPress posts from archives (homepage, search, date/author/term archives).

Adds `` meta to the head to restrict inclusion in web searches.

Background
----------

[](#background)

This plugin provides a way for content to live inside WordPress and still be accessible by a direct URL but appear hidden everywhere else. Useful for culling older content that shouldn't appear in search results because it is untimely.

Usage
-----

[](#usage)

By default, the plugin will prevent archiveless posts from appearing on the page. This is limited to the [main query](https://developer.wordpress.org/reference/functions/is_main_query/) of the page. It will not affect other queries by default.

Archiveless posts can be excluded from normal queries by passing `exclude_archiveless`:

```
$query = new WP_Query(
  [
    'exclude_archiveless' => true,
    // ...
  ]
);

// Via 'pre_get_posts'.
add_action(
  'pre_get_posts',
  function ( $query ) {
    if ( special_condition() ) {
      $query->set( 'exclude_archiveless', true );
    }
  }
);
```

### Handling archiveless posts with `get_posts()` calls

[](#handling-archiveless-posts-with-get_posts-calls)

Queries made with `get_posts()` will always exclude archiveless posts by default since `get_posts()` sets a default `post_status` of `publish`. To include archiveless posts, you can specify the `post_status` of `any`, declare the `post_status` explicitly with `[ 'publish', 'archiveless' ]`, or pass `include_archiveless` set to true:

```
// $post_ids will include archiveless posts.
$post_ids = get_posts(
  [
    'fields'              => 'ids',
    'include_archiveless' => true,
    'suppress_filters'    => false,
  ]
);

// Or declare the post_status explicitly.
$post_ids = get_posts(
  [
    'fields'              => 'ids',
    'suppress_filters'    => false,
    'post_status'         => [ 'archiveless', 'publish' ],
  ]
);
```

### Install

[](#install)

The plugin includes uncompiled Javascript. You can install the plugin by tracking the `main-built` branch or by using a `*-built` tag. Otherwise, you can download the plugin and compile the assets manually:

```
npm install
npm run build
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Maintainers
-----------

[](#maintainers)

This project is actively maintained by [Alley Interactive](https://github.com/alleyinteractive). Like what you see? [Come work with us](https://alley.com/careers/).

[![Alley logo](https://avatars.githubusercontent.com/u/1733454?s=200&v=4)](https://avatars.githubusercontent.com/u/1733454?s=200&v=4)

License
-------

[](#license)

This software is released under the terms of the GNU General Public License version 2 or any later version.

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance73

Regular maintenance activity

Popularity32

Limited adoption so far

Community23

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 54% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~385 days

Total

4

Last Release

208d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/338d27065b1074f2d66d049d742f22996dd137eef6f91bc8f75350ceee1e8ef2?d=identicon)[srtfisher](/maintainers/srtfisher)

![](https://www.gravatar.com/avatar/d2679da8ee30c4d7eae16ffd2271484027b3b27be6d7fb8202d5e4c6d210881d?d=identicon)[alleyinteractive](/maintainers/alleyinteractive)

---

Top Contributors

[![srtfisher](https://avatars.githubusercontent.com/u/346399?v=4)](https://github.com/srtfisher "srtfisher (67 commits)")[![kevinfodness](https://avatars.githubusercontent.com/u/2650828?v=4)](https://github.com/kevinfodness "kevinfodness (21 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (9 commits)")[![renatonascalves](https://avatars.githubusercontent.com/u/19148962?v=4)](https://github.com/renatonascalves "renatonascalves (8 commits)")[![mboynes](https://avatars.githubusercontent.com/u/465154?v=4)](https://github.com/mboynes "mboynes (8 commits)")[![jomurgel](https://avatars.githubusercontent.com/u/5230729?v=4)](https://github.com/jomurgel "jomurgel (5 commits)")[![vancoder](https://avatars.githubusercontent.com/u/1987246?v=4)](https://github.com/vancoder "vancoder (3 commits)")[![benpbolton](https://avatars.githubusercontent.com/u/7146063?v=4)](https://github.com/benpbolton "benpbolton (2 commits)")[![jameswburke](https://avatars.githubusercontent.com/u/665107?v=4)](https://github.com/jameswburke "jameswburke (1 commits)")

### Embed Badge

![Health badge](/badges/alleyinteractive-archiveless/health.svg)

```
[![Health](https://phpackages.com/badges/alleyinteractive-archiveless/health.svg)](https://phpackages.com/packages/alleyinteractive-archiveless)
```

###  Alternatives

[liaison/revision

Seamless software updates library for CodeIgniter4 projects.

186.4k1](/packages/liaison-revision)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)