{"id":23768703,"url":"https://github.com/benface/grav-plugin-groove","last_synced_at":"2025-09-11T23:41:04.026Z","repository":{"id":96092647,"uuid":"84278938","full_name":"benface/grav-plugin-groove","owner":"benface","description":"Grav plugin to create Groove tickets","archived":false,"fork":false,"pushed_at":"2022-01-02T17:01:21.000Z","size":5,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-11T17:53:10.181Z","etag":null,"topics":["grav","grav-plugin","groove"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/benface.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-03-08T04:38:14.000Z","updated_at":"2020-07-19T20:49:11.000Z","dependencies_parsed_at":null,"dependency_job_id":"599b8e06-44ea-4c28-92ac-3724e67e2371","html_url":"https://github.com/benface/grav-plugin-groove","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/benface/grav-plugin-groove","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benface%2Fgrav-plugin-groove","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benface%2Fgrav-plugin-groove/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benface%2Fgrav-plugin-groove/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benface%2Fgrav-plugin-groove/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/benface","download_url":"https://codeload.github.com/benface/grav-plugin-groove/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benface%2Fgrav-plugin-groove/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274727292,"owners_count":25338399,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-11T02:00:13.660Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["grav","grav-plugin","groove"],"created_at":"2025-01-01T01:38:56.333Z","updated_at":"2025-09-11T23:41:04.019Z","avatar_url":"https://github.com/benface.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Grav Groove Plugin\n\nThis [Grav](http://github.com/getgrav/grav) plugin creates a ticket in your [Groove](https://www.groovehq.com) mailbox when the user submits a form.\n\n## Installing / Updating\n\nYou can install this plugin through the [Grav Package Manager (GPM)](http://learn.getgrav.org/advanced/grav-gpm):\n\n    bin/gpm install groove\n\nThis will install the plugin into your `/user/plugins` directory within Grav. To update to the latest version:\n\n    bin/gpm update groove\n\n## Configuration\n\nUser configuration should go in `/user/config/plugins/groove.yaml`. Here's a sample config file:\n\n    enabled: true\n    api_token: xxxxxxxxxxxxx\n    to: contact@yourdomain.com\n    subject: Contact Form\n\n* `api_token` **(required)**: Your private token from Groove.\n* `to` (optional): The email address of the mailbox to create tickets in. This can be overridden in the page that contains the form. If it is not set here, then it has to be set in the page.\n* `subject` (optional): The default subject for new tickets. This setting can also be overridden/set in a page, or be omitted entirely (Groove uses the first characters of the body as the subject when it is not specified).\n\n## Usage\n\nHere's how you would use this plugin in a page that contains a form:\n\n    form:\n        name: contact\n        fields:\n            -\n                name: name\n                label: 'Name'\n                type: text\n            -\n                name: email\n                label: 'Email Address'\n                type: email\n            -\n                name: subject\n                label: 'Subject'\n                type: text\n            -\n                name: message\n                label: 'Message'\n                type: textarea\n        buttons:\n            - type: submit\n              value: Submit\n        process:\n            -\n                groove:\n                    from:\n                        name: '{{ form.value.name }}'\n                        email: '{{ form.value.email }}'\n                    subject: '{{ form.value.subject }}'\n                    body: '{{ form.value.message|nl2br }}'\n\nLet's look at the parameters of the `groove` form action:\n\n* `from` **(required)**: Can be a simple email address, or (as shown above) an array containing a name and an email.\n* `to` (optional, or required if not set in the plugin's config): The email address of the Groove mailbox to create the ticket in.\n* `subject` (optional): The subject line for the ticket. If omitted, the plugin's `subject` setting will be used.\n* `body` **(required)**: The content of the ticket itself, as HTML.\n\n## Credits / Thanks\n\nMost of the `GrooveAPI` class is taken from [Groove-PHP-Wrapper](https://github.com/paamayim/Groove-PHP-Wrapper). It would be nice to add it as a proper dependency of this plugin, but it doesn't use Composer (and until the author accepts my pull request, it doesn't include the only method of the Groove API that this plugin uses).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenface%2Fgrav-plugin-groove","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbenface%2Fgrav-plugin-groove","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenface%2Fgrav-plugin-groove/lists"}