Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/matepaiva/wp-graphql-crb

Wordpress wrapper to expose Carbon Fields to WpGraphQL queries.
https://github.com/matepaiva/wp-graphql-crb

Last synced: about 1 month ago
JSON representation

Wordpress wrapper to expose Carbon Fields to WpGraphQL queries.

Awesome Lists containing this project

README

        

# WpGraphQLCrb

A Wordpress wrapper to expose Carbon Fields to WpGraphQL queries.

## Important

This is just the first version. There is a lot of work to be done. This packages exposes all the fields of the container, if the container type is `post_meta`, `term_meta`, `user_meta`, `comment_meta` or `theme_options`.

> Note: This is a very experimental version, so it is probably shipped with bugs.

## Usage

1. First you have to install Carbon Fields and WpGraphQL.
1. Then install this package via packagist: `composer require matepaiva/wp-graphql-crb`
1. Wrap every Carbon Field container that you want to expose via GraphQL with the static method `WpGraphQLCrb\Container::register`. For example:

```php
where('term_taxonomy', '=', 'category')
->add_fields([
Field::make('image', 'crb_img')
->set_value_type('url')
])
);
```

5. Now the query below will work:

```graphql
{
categories {
edges {
node {
id
crb_img
}
}
}
}
```

## About Theme Options

Theme options are not part of any structure already known by Wordpress, so it has its own root. Every `theme_options` fields will be displayed in GraphQL as direct children of `crb_ThemeOptions`. Be carefull about name collision.