Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore: update repo links and readme #382

Merged
merged 2 commits into from
Sep 17, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .github/ISSUE_TEMPLATE/bug_report.yml
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ body:

Please remember, a bug report is not the place to ask questions. You can
use Slack for that, or start a topic in [GitHub
Discussions](https://github.com/harness-software/wp-graphql-gravity-forms/discussions).
Discussions](https://github.com/axewp/wp-graphql-gravity-forms/discussions).
- type: textarea
attributes:
label: Description
Expand Down Expand Up @@ -69,7 +69,7 @@ body:
label: Please confirm that you have searched existing issues in the repo.
description: >-
You can do this by searching
https://github.com/harness-software/wp-graphql-gravity-forms/issues and making sure the
https://github.com/axewp/wp-graphql-gravity-forms/issues and making sure the
bug is not related to another plugin.
options:
- label: 'Yes'
Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
blank_issues_enabled: true
contact_links:
- name: General Support Request
url: https://github.com/harness-software/wp-graphql-gravity-forms/discussions
url: https://github.com/axewp/wp-graphql-gravity-forms/discussions
about: For general help requests, create a new topic in Github Discussions
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/feature_request.yml
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ body:


Please make sure to search the repo for [existing feature
requests](https://github.com/harness-software/wp-graphql-gravity-forms/issues?q=label%3A%22type%3A+enhancement+%E2%9A%A1%22+label%3A%22type%3A+feature+%F0%9F%A6%8B%22+label%3A%22type%3A+idea+%F0%9F%92%A1%22+)
requests](https://github.com/axewp/wp-graphql-gravity-forms/issues?q=label%3A%22type%3A+enhancement+%E2%9A%A1%22+label%3A%22type%3A+feature+%F0%9F%A6%8B%22+label%3A%22type%3A+idea+%F0%9F%92%A1%22+)
before creating a new one.
- type: textarea
attributes:
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/schema-linter.yml
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,7 @@ jobs:
echo "Previous tagged schema ${{ steps.get-latest-tag.outputs.tag }}"

- name: Get Previous Released Schema
run: curl 'https://github.com/harness-software/wp-graphql-gravity-forms/releases/download/${{ steps.get-latest-tag.outputs.tag }}/schema.graphql' -L --output /tmp/${{ steps.get-latest-tag.outputs.tag }}.graphql
run: curl 'https://github.com/axewp/wp-graphql-gravity-forms/releases/download/${{ steps.get-latest-tag.outputs.tag }}/schema.graphql' -L --output /tmp/${{ steps.get-latest-tag.outputs.tag }}.graphql

# https://github.com/marketplace/actions/graphql-inspector
- name: Install Schema Inspector
Expand Down
7 changes: 4 additions & 3 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@
- chore: Fix Composer PHP version constraints and rebuild lockfile. Thanks @szepeviktor!
- chore: Update WPGraphQL Coding Standards to 2.0.0-beta.1 and fix resulting issues.
- chore: Update Composer dev-deps.
- chore: Update links to repo and README.
- tests: Set `WPLoader.loadOnly` to true for acceptance suite. Thanks @lucatume!
- ci: Fix GitHub Action workflows by locking MariaDB version to v10.
- ci: Test against WordPress 6.3 and PHP 8.1
Expand Down Expand Up @@ -548,7 +549,7 @@ This minor release addresses an issue where `PostImageInput` would be registered
* tests: add WPUnit tests for `ListField`, `MultiSelectField`, `NameField`, `TimeField`, `PostContentField`, `PostTitleField`, `PostExcerptField`, `GFUtils::get_forms()`, `Utils::maybe_decode_json()`, and `WPGraphQLGravityForms::instances()`
* tests: remove tests for `{fieldType}FieldValue` edges since they're deprecated anyway.

**Note** As part of the road to v1.0, [the next release will](https://github.com/harness-software/wp-graphql-gravity-forms/issues?q=is%3Aopen+is%3Aissue+milestone%3Av0.10) contain numerous breaking changes to the codebase AND schema, including the removal of deprecated code (such as FieldValue edges). Please prepare accordingly.
**Note** As part of the road to v1.0, [the next release will](https://github.com/axewp/wp-graphql-gravity-forms/issues?q=is%3Aopen+is%3Aissue+milestone%3Av0.10) contain numerous breaking changes to the codebase AND schema, including the removal of deprecated code (such as FieldValue edges). Please prepare accordingly.

## v0.9.1 - Gravity Forms Quiz Support

Expand Down Expand Up @@ -901,7 +902,7 @@ Beyond that, we've squashed some bugs, deprecated some confusing and unnecessary

### New features

* Added `submitGravityFormsForm` mutation to bypass the existing draft entry flow. See [README. MD](https://github.com/harness-software/wp-graphql-gravity-forms/README.md#documentation-submit-form-mutation) for usage.
* Added `submitGravityFormsForm` mutation to bypass the existing draft entry flow. See [README. MD](https://github.com/axewp/wp-graphql-gravity-forms/README.md#documentation-submit-form-mutation) for usage.
* Added `updateGravityFormsEntry` and `updateGravityFormsDraftEntry` mutations that follow the same pattern.
* Added `idType` to `GravityFormsForm` and `GravityFormsEntry`, so you can now query them using the database ID, instead of generating a global id first.
* Added `id` property to `FieldErrors`, so you know which failed validation.
Expand Down Expand Up @@ -1096,4 +1097,4 @@ These properties will be removed in v1.0.

This release takes the last year and a half of work on this plugin, and makes it ready for public consumption and contribution, by adopting SemVer, WordPress Coding Standards, etc.

Please see [README.md](https://github.com/harness-software/wp-graphql-gravity-forms/blob/main/README.md) for a list of all functionality.
Please see [README.md](https://github.com/axewp/wp-graphql-gravity-forms/blob/main/README.md) for a list of all functionality.
47 changes: 33 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,16 @@
![alt text](./assets/icon-128x128.png "WPGraphQL for Gravity Forms Logo")
# WPGraphQL for Gravity Forms

A WordPress plugin that provides a GraphQL API for interacting with Gravity Forms.


![Packagist License](https://img.shields.io/packagist/l/harness-software/wp-graphql-gravity-forms?color=green) ![Packagist Version](https://img.shields.io/packagist/v/harness-software/wp-graphql-gravity-forms?label=stable) ![GitHub commits since latest release (by SemVer)](https://img.shields.io/github/commits-since/harness-software/wp-graphql-gravity-forms/v0.12.2) ![GitHub forks](https://img.shields.io/github/forks/harness-software/wp-graphql-gravity-forms?style=social) ![GitHub Repo stars](https://img.shields.io/github/stars/harness-software/wp-graphql-gravity-forms?style=social)<br />
[![Coverage Status](https://coveralls.io/repos/github/harness-software/wp-graphql-gravity-forms/badge.svg?branch=develop)](https://coveralls.io/github/harness-software/wp-graphql-gravity-forms?branch=develop) [![WordPress Coding Standards](https://github.com/harness-software/wp-graphql-gravity-forms/actions/workflows/code-standard.yml/badge.svg)](https://github.com/harness-software/wp-graphql-gravity-forms/actions/workflows/code-standard.yml) [![Code Quality](https://github.com/harness-software/wp-graphql-gravity-forms/actions/workflows/code-quality.yml/badge.svg)](https://github.com/harness-software/wp-graphql-gravity-forms/actions/workflows/code-quality.yml) [![Schema Linter](https://github.com/harness-software/wp-graphql-gravity-forms/actions/workflows/schema-linter.yml/badge.svg)](https://github.com/harness-software/wp-graphql-gravity-forms/actions/workflows/schema-linter.yml)
A WordPress plugin that adds <a href="https://wpgraphql.com" target="_blank">WPGraphQL</a> support for <a href="https://gravityforms.com" target="_blank">Gravity Forms</a>.

* [Join the WPGraphQL community on Slack.](https://join.slack.com/t/wp-graphql/shared_invite/zt-3vloo60z-PpJV2PFIwEathWDOxCTTLA)
* [Documentation](#documentation)

-----

![Packagist License](https://img.shields.io/packagist/l/harness-software/wp-graphql-gravity-forms?color=green) ![Packagist Version](https://img.shields.io/packagist/v/harness-software/wp-graphql-gravity-forms?label=stable) ![GitHub commits since latest release (by SemVer)](https://img.shields.io/github/commits-since/axewp/wp-graphql-gravity-forms/v0.12.2) ![GitHub forks](https://img.shields.io/github/forks/axewp/wp-graphql-gravity-forms?style=social) ![GitHub Repo stars](https://img.shields.io/github/stars/axewp/wp-graphql-gravity-forms?style=social)<br />
[![Coverage Status](https://coveralls.io/repos/github/AxeWP/wp-graphql-gravity-forms/badge.svg?branch=develop)](https://coveralls.io/github/AxeWP/wp-graphql-gravity-forms?branch=develop) [![WordPress Coding Standards](https://github.com/axewp/wp-graphql-gravity-forms/actions/workflows/code-standard.yml/badge.svg)](https://github.com/axewp/wp-graphql-gravity-forms/actions/workflows/code-standard.yml) [![Code Quality](https://github.com/axewp/wp-graphql-gravity-forms/actions/workflows/code-quality.yml/badge.svg)](https://github.com/axewp/wp-graphql-gravity-forms/actions/workflows/code-quality.yml) [![Schema Linter](https://github.com/axewp/wp-graphql-gravity-forms/actions/workflows/schema-linter.yml/badge.svg)](https://github.com/axewp/wp-graphql-gravity-forms/actions/workflows/schema-linter.yml)

## Overview

Using WordPress as a headless CMS with a separate JavaScript-powered frontend single-page app is an increasingly popular tech stack. Traditionally, REST APIs have been used for the purpose of sending data back & forth between the frontend and backend in setups like this but the REST architecture has its limitations.
Expand All @@ -24,7 +25,7 @@ Our hope for this open source project is that it will enable more teams to lever

## System Requirements

* PHP 7.4+
* PHP 7.4-8.1+
* WordPress 5.4.1+
* WPGraphQL 1.9.0+
* Gravity Forms 2.5+ (Recommend: v2.6+)
Expand All @@ -34,24 +35,34 @@ Our hope for this open source project is that it will enable more teams to lever

1. Install & activate [WPGraphQL](https://www.wpgraphql.com/).
2. Install & activate [Gravity Forms](https://www.gravityforms.com/) and any supported addons.
3. Download the [latest release](https://github.com/harness-software/wp-graphql-gravity-forms/releases) `.zip` file, upload it to your WordPress install, and activate the plugin.
3. Download the [latest release](https://github.com/axewp/wp-graphql-gravity-forms/releases) `.zip` file, upload it to your WordPress install, and activate the plugin.

### With Composer

```console
composer require harness-software/wp-graphql-gravity-forms
```


## Updating and Versioning
As we work [towards a 1.0 Release](https://github.com/harness-software/wp-graphql-gravity-forms/issues/179), we will need to introduce numerous breaking changes. We will do our best to group multiple breaking changes together in a single release, to make it easier on developers to keep their projects up-to-date.

As we work [towards a 1.0 Release](https://github.com/axewp/wp-graphql-gravity-forms/issues/179), we will need to introduce numerous breaking changes. We will do our best to group multiple breaking changes together in a single release, to make it easier on developers to keep their projects up-to-date.

Until we hit v1.0, we're using *a modified version* of [Semantic Versioning](https://semver.org/spec/v2.0.0.html)

v0.x: "Major" releases. These releases introduce new features, and may contain breaking changes to either the PHP API or the GraphQL schema.
v0.x.y: "Minor" releases. These releases introduce new features and enhancements and address bugs. They do not contain breaking changes.
v0.x.y.z: "Patch" releases. These releases are reserved for addressing issue with the previous release only.

## Development and Support

Development of WPGraphQL for Gravity Forms is provided by [AxePress Development](https://axepress.dev). Community contributions are _welcome_ and **encouraged**.

Basic support is provided for free, both in [this repo](https://github.com/axewp/wp-graphql-gravity-forms/issues) and in [WPGraphQL Slack](https://join.slack.com/t/wp-graphql/shared_invite/zt-3vloo60z-PpJV2PFIwEathWDOxCTTLA).

Priority support and custom development are available to [our Sponsors](https://github.com/sponsors/AxeWP).

<a href="https://github.com/sponsors/AxeWP" alt="GitHub Sponsors"><img src="https://img.shields.io/static/v1?label=Sponsor%20Us%20%40%20AxeWP&message=%E2%9D%A4&logo=GitHub&color=%23fe8e86&style=for-the-badge" /></a>

## Supported Features

* Querying forms and entries.
Expand All @@ -62,11 +73,11 @@ v0.x.y.z: "Patch" releases. These releases are reserved for addressing issue wit

## Future Feature Enhancements

[_View all Feature Requests_](https://github.com/harness-software/wp-graphql-gravity-forms/issues?q=is%3Aopen+is%3Aissue+label%3A%22type%3A+enhancement+%E2%9A%A1%22%2C%22type%3A+feature+%F0%9F%A6%8B%22%2C%22type%3A+idea+%F0%9F%92%A1%22)
[_View all Feature Requests_](https://github.com/axewp/wp-graphql-gravity-forms/issues?q=is%3Aopen+is%3Aissue+label%3A%22type%3A+enhancement+%E2%9A%A1%22%2C%22type%3A+feature+%F0%9F%A6%8B%22%2C%22type%3A+idea+%F0%9F%92%A1%22)

* Add support for [remaining form fields](https://github.com/harness-software/wp-graphql-gravity-forms/issues/195)
* Ability to [query for lists of draft entries](https://github.com/harness-software/wp-graphql-gravity-forms/issues/114).
* Ability to [create, update, and delete an individual Gravity Form](https://github.com/harness-software/wp-graphql-gravity-forms/issues/115).
* Add support for [remaining form fields](https://github.com/axewp/wp-graphql-gravity-forms/issues/195)
* Ability to [query for lists of draft entries](https://github.com/axewp/wp-graphql-gravity-forms/issues/114).
* Ability to [create, update, and delete an individual Gravity Form](https://github.com/axewp/wp-graphql-gravity-forms/issues/115).

## Documentation

Expand All @@ -85,4 +96,12 @@ v0.x.y.z: "Patch" releases. These releases are reserved for addressing issue wit
* [Register a Gravity Forms Form to a custom GraphQL field](docs/recipes/register-form-to-custom-field.md)
* [Register a custom GraphQL connection to Gravity Forms entries](docs/recipes/register-custom-entries-connection.md)
* [Register a custom Gravity Forms field to the GraphQL schema](docs/recipes/register-custom-form-field.md)
* [Add GraphQL mutation support for a custom Gravity Forms field](docs/recipes/register-custom-field-value-inputs.md)
* [Add GraphQL mutation support for a custom Gravity Forms field](docs/recipes/register-custom-field-value-inputs.md)

## Sponsors
<div class="sponsor-grid">
<a href="https://mysafetyhq.com/" target="_blank" rel="sponsored" title="SafetyHQ (previously Harness Software)"><img src="https://avatars.githubusercontent.com/u/50597878?s=150&v=4" alt="SafetyHQ (previously Harness Software)"></a>
</div>


<a href="https://github.com/sponsors/AxeWP" alt="GitHub Sponsors"><img src="https://img.shields.io/static/v1?label=Sponsor%20Us%20%40%20AxeWP&message=%E2%9D%A4&logo=GitHub&color=%23fe8e86&style=for-the-badge" /></a>
14 changes: 8 additions & 6 deletions composer.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,17 +4,19 @@
"type": "wordpress-plugin",
"license": "GPL-3.0-or-later",
"support": {
"issues": "https://github.com/harness-software/wp-graphql-gravity-forms/issues",
"source": "https://github.com/harness-software/wp-graphql-gravity-forms"
"issues": "https://github.com/axewp/wp-graphql-gravity-forms/issues",
"source": "https://github.com/axewp/wp-graphql-gravity-forms"
},
"authors": [
{
"name": "Harness Software",
"email": "info@harnessup.com"
"name": "AxePress Development",
"email": "support@axepress.dev",
"homepage": "https://axepress.dev"
},
{
"name": "Dovid Levine",
"role": "Lead Developer"
"name": "David Levine",
"role": "Lead Developer",
"email": "david@axepress.dev"
}
],
"require": {
Expand Down
2 changes: 1 addition & 1 deletion docker/app.Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ ENV WP_VERSION=${WP_VERSION}
ENV PHP_VERSION=${PHP_VERSION}

LABEL author=harness
LABEL author_uri=https://github.com/harness-software
LABEL author_uri=https://github.com/axewp

SHELL [ "/bin/bash", "-c" ]

Expand Down
4 changes: 2 additions & 2 deletions docker/testing.Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ ARG PHP_VERSION
FROM wp-graphql-gravity-forms:latest-wp${WP_VERSION}-php${PHP_VERSION}

LABEL author=harness
LABEL author_uri=https://github.com/harness-software
LABEL author_uri=https://github.com/axewp

SHELL [ "/bin/bash", "-c" ]

Expand Down Expand Up @@ -40,4 +40,4 @@ RUN echo "date.timezone = UTC" >> /usr/local/etc/php/php.ini
WORKDIR /var/www/html
COPY docker/testing.entrypoint.sh /usr/local/bin/testing-entrypoint.sh
RUN chmod 755 /usr/local/bin/testing-entrypoint.sh
ENTRYPOINT ["testing-entrypoint.sh"]
ENTRYPOINT ["testing-entrypoint.sh"]
2 changes: 1 addition & 1 deletion docs/form-field-support.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ By default, WPGraphQL for Gravity Forms adds basic query support for _all_ Form

These types inherit the `FormField` interface.

*Note:* As of v0.10.0, [Experimental fields are hidden by default and must be enabled](#experimental-fields). To track implementation status of experimental fields, please review [this github issue](https://github.com/harness-software/wp-graphql-gravity-forms/issues/195)
*Note:* As of v0.10.0, [Experimental fields are hidden by default and must be enabled](#experimental-fields). To track implementation status of experimental fields, please review [this github issue](https://github.com/axewp/wp-graphql-gravity-forms/issues/195)

## Form Field properties (GraphQL fields) <a name="form-field-properties" />

Expand Down
6 changes: 3 additions & 3 deletions docs/recipes/register-custom-field-value-inputs.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ While the needs of each form field are different, the following guide lays out s

Depending on how complex your Form Field is, you might want to create a custom GraphQL Input type for the form field value.

If your field is using a [preexisting `FormFieldValues` type](https://github.com/harness-software/wp-graphql-gravity-forms/blob/develop/src/Type/Input/FormFieldValuesInput.php#L34) ( e.g. `value` , `values` , `checkboxValues` ), you can skip this step. _However_, we recommend creating a custom input type for every custom GF form to [protect yourself against future breaking changes to the schema](https://www.apollographql.com/blog/graphql/basics/designing-graphql-mutations/).
If your field is using a [preexisting `FormFieldValues` type](https://github.com/axewp/wp-graphql-gravity-forms/blob/develop/src/Type/Input/FormFieldValuesInput.php#L34) ( e.g. `value` , `values` , `checkboxValues` ), you can skip this step. _However_, we recommend creating a custom input type for every custom GF form to [protect yourself against future breaking changes to the schema](https://www.apollographql.com/blog/graphql/basics/designing-graphql-mutations/).

For example:

Expand Down Expand Up @@ -45,13 +45,13 @@ add_filter(

### Preparing the GraphQL data for Gravity Forms.

WPGraphQL for Gravity Forms passes the GraphQL input args through [the `AbstractFieldValueInput` class](https://github.com/harness-software/wp-graphql-gravity-forms/blob/develop/src/Data/FieldValueInput/AbstractFieldValueInput.php) to make it easy to process the data for Gravity Forms.
WPGraphQL for Gravity Forms passes the GraphQL input args through [the `AbstractFieldValueInput` class](https://github.com/axewp/wp-graphql-gravity-forms/blob/develop/src/Data/FieldValueInput/AbstractFieldValueInput.php) to make it easy to process the data for Gravity Forms.

For custom fields, we recommend extending the above class, and then registering it with [the `graphql_gf_field_value_input_class` filter](../actions-and-filters.md#graphql_gf_field_value_input). If you wish to change the behavior of one of the default `FieldValueInput` s, you can make use of several WordPress filters.

#### Example 1: Extending `AbstractFieldValueInput`

The following example shows how to create a custom FieldValueInput object to handle submissions for your custom Form Field. For a full understanding, you should review the comments in [the source code](https://github.com/harness-software/wp-graphql-gravity-forms/blob/develop/src/Data/FieldValueInput/AbstractFieldValueInput.php).
The following example shows how to create a custom FieldValueInput object to handle submissions for your custom Form Field. For a full understanding, you should review the comments in [the source code](https://github.com/axewp/wp-graphql-gravity-forms/blob/develop/src/Data/FieldValueInput/AbstractFieldValueInput.php).

```php
class MyCustomFieldValueInput extends \WPGraphQL\GF\Data\FieldValueInput\AbstractFieldValueInput {
Expand Down
Loading
Loading