PHPackages                             amphibee/wpgb-extended - 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. amphibee/wpgb-extended

ActiveWordpress-muplugin

amphibee/wpgb-extended
======================

Register Gridbuilder ᵂᴾ template and (soon) facets with object oriented PHP

1.13(3y ago)614.5k↓30.4%3[4 PRs](https://github.com/AmphiBee/wpgb-extended/pulls)MITPHPPHP ^7.4 || ^8.0

Since Aug 18Pushed 2mo ago3 watchersCompare

[ Source](https://github.com/AmphiBee/wpgb-extended)[ Packagist](https://packagist.org/packages/amphibee/wpgb-extended)[ RSS](/packages/amphibee-wpgb-extended/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (3)Versions (13)Used By (0)

Gridbuilder ᵂᴾ Extended
=======================

[](#gridbuilder-ᵂᴾ-extended)

> Register [Gridbuilder ᵂᴾ](https://www.wpgridbuilder.com) with object oriented PHP.

Gridbuilder ᵂᴾ Extended provides an object oriented API to register templates and (soon) facets. If you register template or facets in your theme, you can safely rely on version control when working with other developers.

- [Installation](#installation)
- [Templates](#templates)
- [Facets](#facets)
- [Content sync](#content-sync)

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

[](#installation)

Require this package, with Composer, in the root directory of your project.

```
composer require amphibee/wpgb-extended
```

Download the [Gridbuilder ᵂᴾ](https://wpgridbuilder.com/pricing/) plugin and put it in either the `plugins` or `mu-plugins` directory. Visit the WordPress dashboard and activate the plugin. Please note that this package supports Gridbuilder ᵂᴾ version 1.4 or higher.

Templates
---------

[](#templates)

Use the `Template::make()` function to register a new template. Below you'll find an example of a template registration.

```
use WpgbExtended\Facades\Template;

Template::make('post-list')
  ->setSourceType('post')
  ->setClasses(['list', 'is-full-width'])
  ->setWrapperTag('ul')
  ->setQueryArgs([
    'post_type'      => 'post',
    'posts_per_page' => 10,
  ])
  ->setRenderCallback('prefix_render_callback')
  ->setNoResultsCallback('prefix_noresults_callback');
```

Visit the official [Gridbuilder ᵂᴾ template documentation](https://docs.wpgridbuilder.com/resources/filter-templates/) to read more about the template settings.

Facets
------

[](#facets)

### Get facet by slug

[](#get-facet-by-slug)

You have now the possibility to get facet by slug

```
wpgb_render_facet([
  'slug' => 'pagination',
  'grid' => 'post-list'
])

```

### Improved facet rendering

[](#improved-facet-rendering)

Facets have the slug class make you more powerful styling !

Note : by default, class are only added when `wpgb_render_facet` is called by slug. If you want to enable it when a facet is called by ID, you need to enable it with this filter :

```
add_filter('wpgb_extended/enable_facet_class_from_db', '__return_true');

```

### Registering facets

[](#registering-facets)

@TODO

Content sync
------------

[](#content-sync)

Gridbuilder ᵂᴾ Extended allows you to synchronize all of your content (grids, cards, facets). This is useful when working with multiple environments (local, staging, production). Like Advanced Custom Fields, the grids, cards, facets are stored in json files. By default, they are stored in your theme folder (`wpgb-json` folder). You can customize this folder with the `wpgb_extended/sync/json_folder` filter

It's possible to deactivate the synchronization globally with the filter `wp_grid_builder/enable_sync` or to deactivate it by entity with the filter `wpgb/{$type}/enable_sync` (ex. `wpgb/card/enable_sync`)

*Note: For maps and grids, Gridbuilder ᵂᴾ does not offer a single slug. Gridbuilder ᵂᴾ Extended is based on name by default. It is therefore important to be aware that it will not have to change in the meantime in which case, a duplicate will be created. In the same way, it is important that the name is unique otherwise it will generate conflicts on synchronizations (an alert function will be planned on the next versions)*

###  Health Score

45

—

FairBetter than 93% of packages

Maintenance55

Moderate activity, may be stable

Popularity32

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 76% 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 ~90 days

Recently: every ~74 days

Total

6

Last Release

1281d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8435080f3e74b629258f291a62cb72aa9d63ee44d74e588f594dc6378c328fa2?d=identicon)[amphibee](/maintainers/amphibee)

![](https://avatars.githubusercontent.com/u/293510?v=4)[lhall](/maintainers/lhall)[@lhall](https://github.com/lhall)

---

Top Contributors

[![ogorzalka](https://avatars.githubusercontent.com/u/149651?v=4)](https://github.com/ogorzalka "ogorzalka (38 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (9 commits)")[![lhall-amphibee](https://avatars.githubusercontent.com/u/15910616?v=4)](https://github.com/lhall-amphibee "lhall-amphibee (2 commits)")[![tgeorgel](https://avatars.githubusercontent.com/u/11785727?v=4)](https://github.com/tgeorgel "tgeorgel (1 commits)")

---

Tags

wordpressbuildergridwpwpgbamphibee

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/amphibee-wpgb-extended/health.svg)

```
[![Health](https://phpackages.com/badges/amphibee-wpgb-extended/health.svg)](https://phpackages.com/packages/amphibee-wpgb-extended)
```

###  Alternatives

[roots/bedrock

WordPress boilerplate with Composer, easier configuration, and an improved folder structure

6.5k441.8k2](/packages/roots-bedrock)[ffraenz/private-composer-installer

A composer install helper for private packages

2331.7M5](/packages/ffraenz-private-composer-installer)[wecodemore/wpstarter

Composer plugin to easily build WordPress websites entirely managed via Composer.

253195.2k6](/packages/wecodemore-wpstarter)[gotoandplay/gravityforms-composer-installer

A composer install helper for Gravity Forms

31389.9k](/packages/gotoandplay-gravityforms-composer-installer)[seravo/seravo-plugin

Enhances WordPress with Seravo.com specific features and integrations

40162.2k1](/packages/seravo-seravo-plugin)[codesvault/howdy-qb

Mysql Query Builder for WordPress

371.2k1](/packages/codesvault-howdy-qb)

PHPackages © 2026

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