Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/harness-software/wp-graphql-posts-to-posts
Creates GraphQL connections for all registered Posts 2 Posts connections.
https://github.com/harness-software/wp-graphql-posts-to-posts
Last synced: 3 months ago
JSON representation
Creates GraphQL connections for all registered Posts 2 Posts connections.
- Host: GitHub
- URL: https://github.com/harness-software/wp-graphql-posts-to-posts
- Owner: harness-software
- Created: 2020-08-28T15:17:44.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-03-28T23:40:59.000Z (almost 2 years ago)
- Last Synced: 2024-08-02T05:15:35.856Z (6 months ago)
- Language: PHP
- Size: 90.8 KB
- Stars: 8
- Watchers: 3
- Forks: 5
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-wordpress-gatsby - WPGraphQL for Posts 2 Posts - This FREE plugin from @KellenMace of @harness_up automatically creates GraphQL connections for all of your Posts 2 Posts connections. (Plugins / WordPress)
README
# 📄↔📄 WPGraphQL for Posts 2 Posts
WordPress plugin that creates GraphQL connections for all of your [Posts 2 Posts](https://wordpress.org/plugins/posts-to-posts/) connections.
## Overview
- All registered Posts 2 Posts connections will be automatically added as connections in the GraphQL schema.
- The field for each in the GraphQL schema will be the name of the Posts 2 Post connection, converted to camelCase and with the word "Connection" appended to it. So if the Posts 2 Posts connection is registered as `projects_to_managers`, the field in the GraphQL schema will be named `projectsToManagersConnection` (see the example below).
- Supports posts<->posts, posts<->users, and users<->users connections.
### Example
Let's say you have registered a Posts 2 Posts connection between the `project` custom post type on your site and the `user` object, like this:
```php
function register_p2p_connection() {
p2p_register_connection_type( [
'name' => 'projects_to_managers',
'from' => 'project',
'to' => 'user'
] );
}
add_action( 'p2p_init', 'register_p2p_connection' );
```
With this plugin activated, you can query for the users connected to projects, like this:
```graphql
query getProjects {
projects(first: 10) {
nodes {
databaseId
title
projectsToManagersConnection {
nodes {
databaseId
name
}
}
}
}
}
```
You can also query from the other direction, and get the projects connected to users, like this:
```graphql
query getUsers {
users(first: 10) {
nodes {
databaseId
name
projectsToManagersConnection {
nodes {
databaseId
title
}
}
}
}
}
```
## Minimum Software Requirements
- PHP 7.4+
- [WPGraphQL](https://github.com/wp-graphql/wp-graphql) 1.8.1+ (1.10.0+ recommended)
- [Posts 2 Posts](https://wordpress.org/plugins/posts-to-posts/) 1.6.6+
## Future Enhancements
1. Register a `where` arg for each post type/user object so you can query to find posts/users that are connected to them.
2. Expose [connection metadata](https://github.com/scribu/wp-posts-to-posts/wiki/Connection-metadata) as edge fields in the GraphQL schema.
3. Register input fields for the create & update mutations so you can update the connections.
I think the input fields for #3 will end up looking something like this:
```graphql
projectsToManagersConnections: {
append: false
databaseIds: [1,4,8]
}
```