PHPackages                             jazzsequence/games-collector - 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. jazzsequence/games-collector

ActiveWordpress-plugin

jazzsequence/games-collector
============================

A WordPress plugin to catalog all your tabletop (or other) games in your WordPress site and display a list of games in your collection.

2.0.0(1mo ago)2719[5 issues](https://github.com/jazzsequence/games-collector/issues)[1 PRs](https://github.com/jazzsequence/games-collector/pulls)GPL-3.0PHPCI passing

Since Jan 5Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/jazzsequence/games-collector)[ Packagist](https://packagist.org/packages/jazzsequence/games-collector)[ RSS](/packages/jazzsequence-games-collector/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelog (10)Dependencies (16)Versions (26)Used By (0)

Games Collector
===============

[](#games-collector)

[![Lint & Test](https://github.com/jazzsequence/games-collector/actions/workflows/lint-test.yml/badge.svg?branch=develop)](https://github.com/jazzsequence/games-collector/actions/workflows/lint-test.yml) [![Code Coverage](https://camo.githubusercontent.com/7fa4d9e49a52599dc5460de72681ec4878d0059f9872df124cacfcce837e77c2/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6a617a7a73657175656e63652f67616d65732d636f6c6c6563746f722f6261646765732f636f7665726167652e706e673f623d646576656c6f70)](https://scrutinizer-ci.com/g/jazzsequence/games-collector/?branch=develop) [![License: GPL v3](https://camo.githubusercontent.com/1b0c7e4911720d0444c16a1ffd145a039f14a1a7305362ab51184f757a4dd6bc/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d47504c25323076332d626c75652e737667)](http://www.gnu.org/licenses/gpl-3.0)

**Contributors:** [jazzsequence](https://github.com/jazzsequence)
**Donate link:**
**Tags:**
**Requires at least:** 4.4
**Tested up to:** 6.9
**Stable tag:** 2.0.0
**License:** GPLv3
**License URI:**
**Demo:**

Description
-----------

[](#description)

Catalog all your tabletop (or other) games in your WordPress site and display a list of games in your collection.

You can checkout a live [demo](https://jazzsequence.com/games/) of the plugin (with some custom CSS added) [on my blog](https://jazzsequence.com/games/).

Installation
------------

[](#installation)

### Manual Installation

[](#manual-installation)

1. [Download the latest version](https://github.com/jazzsequence/games-collector/releases/tag/1.0.0) from the [Releases](https://github.com/jazzsequence/games-collector/releases/latest) page.
2. Unzip and upload the entire `/games-collector` directory to the `/wp-content/plugins/` directory.
3. Activate Games Collector through the 'Plugins' menu in WordPress.
4. Create a new page, name it whatever you like, and add the shortcode to the page content to display your games list: `[games-collector]`.

Frequently Asked Questions
--------------------------

[](#frequently-asked-questions)

Screenshots
-----------

[](#screenshots)

[![Games Collector new game screen](https://camo.githubusercontent.com/c081eca8cf965d83fbaa94c810919e30059bfb6f4466a92873600647aa1d2be3/68747470733a2f2f69312e77702e636f6d2f6a617a7a73657175656e63652e636f6d2f77702d636f6e74656e742f75706c6f6164732f323031372f30322f53637265656e73686f742d323031372d30322d30332d31342e34382e32362e706e67)](https://camo.githubusercontent.com/c081eca8cf965d83fbaa94c810919e30059bfb6f4466a92873600647aa1d2be3/68747470733a2f2f69312e77702e636f6d2f6a617a7a73657175656e63652e636f6d2f77702d636f6e74656e742f75706c6f6164732f323031372f30322f53637265656e73686f742d323031372d30322d30332d31342e34382e32362e706e67)

[![Games Collector admin](https://camo.githubusercontent.com/41fe7cbd182eaafb5c9b0cb3fb1e5e7f5ba5f53d0c3407f1f15aa449bbc570fc/68747470733a2f2f6a617a7a73657175656e63652e636f6d2f77702d636f6e74656e742f75706c6f6164732f323031372f30322f53637265656e73686f742d323031372d30322d30332d31352e30362e31372e706e67)](https://camo.githubusercontent.com/41fe7cbd182eaafb5c9b0cb3fb1e5e7f5ba5f53d0c3407f1f15aa449bbc570fc/68747470733a2f2f6a617a7a73657175656e63652e636f6d2f77702d636f6e74656e742f75706c6f6164732f323031372f30322f53637265656e73686f742d323031372d30322d30332d31352e30362e31372e706e67)

[![Games Collector add from BGG](https://camo.githubusercontent.com/58c5234905f929a1f72d66f605091a1a1eac789e2026302ee7ab2c217f4b4645/68747470733a2f2f692e696d6775722e636f6d2f3462527433364a2e676966)](https://camo.githubusercontent.com/58c5234905f929a1f72d66f605091a1a1eac789e2026302ee7ab2c217f4b4645/68747470733a2f2f692e696d6775722e636f6d2f3462527433364a2e676966)

[![Games Collector Gutenberg block](https://user-images.githubusercontent.com/991511/45578321-f6ec5780-b83d-11e8-949e-cb56907af0a5.png)](https://user-images.githubusercontent.com/991511/45578321-f6ec5780-b83d-11e8-949e-cb56907af0a5.png)

Changelog
---------

[](#changelog)

### 2.0.0

[](#200)

- **Breaking change**: BoardGameGeek API now requires a registered Bearer token for all XML API requests. BGG search and import will not function without a token. Register your application at [boardgamegeek.com/applications](https://boardgamegeek.com/applications) and add your token under Games → Settings.
- Added BGG API Token settings page under the Games admin menu.
- Admin notice on all game screens when no BGG token is configured.
- Token can also be defined as a constant in wp-config.php: `define( 'GC_BGG_API_TOKEN', 'your-token' );`
- Added public REST endpoint `GET /wp-json/gc/v1/games` for headless frontend access.
- Upgraded to PHP 8.3 as minimum tested version.
- BGG API requests now use `boardgamegeek.com` (without www) per BGG documentation.

### 1.3.6

[](#136)

- Added handling for when CMB2 (or Extended CPTs) is not loaded correctly. \[[\#73](https://github.com/jazzsequence/games-collector/pull/73)\]

### 1.3.5

[](#135)

- Added actual `composer.json` file so the plugin could be installed via Packagist. \[[\#71](https://github.com/jazzsequence/games-collector/pull/71)\]

### 1.3.4

[](#134)

- use the jQuery implementation of Isotope

### 1.3.3

[](#133)

- require isotope as a dependency for our isotope loader

### 1.3.2

[](#132)

- Update version for new Composer build

### 1.3.1

[](#131)

- Uses composer for dependencies and updates paths

### 1.3.0

[](#130)

- Added first Gutenberg block! Now you can add your games list in Gutenberg rather than using a shortcode. More Gutenberg blocks to come.

### 1.2.0

[](#120)

- Added integration with Board Game Geek API. Games can now be added by searching BGG for matching titles and information imported and automatically added to new games.
- Fixed an issue where games with an indeterminate max number of players was displaying a 0 value (e.g. `2 - 0 players`) and combined that with games with an unrealistically large number of players (e.g. `2 - 99 players`) to display `{{min_players}}+ players` e.g. `2+ players`.
- Refactored the `gc_number_players` filter to only filter the actual number of players and added a `gc_number_players_output` filter which can filter the entire output (what `gc_number_players` previously did).
- Fixed an issue where only the highest difficulty was displaying in the dropdown.
- Fixed a display issue where games that can only be played with a specific number of players were still displaying the min/max player numbers. Changed to just display the number of players, e.g. `2 players` instead of `2 - 2 players`.
- Dropped support for `hhvm` and php 5.x. Require minimum of PHP 7.0.
- Scrutinizer CI integration for code coverage and quality checking.
- Cleaned up some code as a result of Scrutinizer sniffs.

### 1.1.0

[](#110)

- Add activation hook that will create a Games page with the shortcode on plugin activation.
- Fixed some display errors and undefined notices on titles.
- Added more filters for display output. Now buttons can be filtered individually and therefore disabled.
- Switched to SVG images for game info icons which required some CSS changes.
- Cleaned up spacing for game attributes.
- Added [Shortcode UI](https://wordpress.org/plugins/shortcode-ui/) integration.
- Added shortcode that allows you to display a single or multiple specific games using `[games-collector-list gc_game="1,2,3"]`.

### 1.0.0

[](#100)

- abstracted display elements into smaller functions and made them filterable
- added capability of SVGs to be output in base64-encoded or raw svg XML markup

### 0.2

[](#02)

- Integrated Travis CI
- Added unit tests
- Adjusted filters for sorting
- Changed attribute link in game list
- Changed ordering of games (alphabetically *ascending*)
- Changed the post type to remove links to single game entry in admin
- Added front end styles and SVG icons
- Added shortcode
- Added WordPress filters

### 0.1

[](#01)

- First release

Upgrade Notice
--------------

[](#upgrade-notice)

### 0.1

[](#01-1)

First Release

###  Health Score

49

—

FairBetter than 94% of packages

Maintenance77

Regular maintenance activity

Popularity22

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 96.4% 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 ~335 days

Recently: every ~568 days

Total

11

Last Release

52d ago

Major Versions

0.2 → 1.0.02017-02-03

1.3.6 → 2.0.02026-03-17

### Community

Maintainers

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

---

Top Contributors

[![jazzsequence](https://avatars.githubusercontent.com/u/991511?v=4)](https://github.com/jazzsequence "jazzsequence (535 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (19 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (1 commits)")

---

Tags

games-collectorhacktoberfesttabletop-gameswordpresswordpress-plugin

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/jazzsequence-games-collector/health.svg)

```
[![Health](https://phpackages.com/badges/jazzsequence-games-collector/health.svg)](https://phpackages.com/packages/jazzsequence-games-collector)
```

###  Alternatives

[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

44643.1k1](/packages/pressbooks-pressbooks)[log1x/poet

Configuration-based post type, taxonomy, editor color palette, block category, and block registration for Sage 10.

218280.1k1](/packages/log1x-poet)[altis/aws-analytics

AWS Pinpoint Analytics integration for WordPress

19144.1k4](/packages/altis-aws-analytics)[rankmath/seo-by-rank-math

Rank Math is the most powerful way to get BEST WordPress SEO tools added to your website.

1252.0k](/packages/rankmath-seo-by-rank-math)[roots/acorn-post-types

Simple post types and taxonomies using Extended CPTs for Acorn.

1221.8k](/packages/roots-acorn-post-types)

PHPackages © 2026

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