chore: Added BETA plugins to packagist.org for composer users

[colinmurphy]

Overview

We need to add webhooks and previews to packagist.org for composer users. (Thanks justlevine for the suggestion)

Update

Based on feedback we are going to do the following

1. Create a package.json file for composer within the toolkit
2. Add plugins to this package.json
3. Add docs on how to add plugins to composer (and also might be with covering how to create a plugin for the toolit)

References:

• https://connect.advancedcustomfields.com/packages.json
• https://www.advancedcustomfields.com/resources/installing-acf-with-composer/

Tasks

• Research best approach on how to set the account up
• Contact key stakeholders internally on best approach
• Add a script for Previews to update composer and plugin version (using the script "version" which is used by changeset when creating a changset)
• Add a script for Webhooks to update composer and plugin version (using the script "version" which is used by changeset when creating a changset)
• Add a package.json for installing composer packages
• Test composer package install
• Add docs to the toolkit on how to install plugins via composer (or add a plugin)
• Update Previews README with link to new doc
• Update Webhooks README with link to new doc
• Merge and test afterwards with version updates

Post Merge Checks

• Merge and test release process for Previews
• Merge and test release process for Webhooks
• Test composer installs
• Add docs on Github workflow and how to setup a new plugin

[colinmurphy]

@wpengine/headless-open-source @wpengine-cpierce

I am just seeing what account should we use to add these plugins to packagist.org?

[moonmeister]

@colinmurphy It's been a while since I published to composer, but I don't think it matters. Use your personal account. What we need to decide is the vendor prefix, correct?

[moonmeister]

That said, can multiple accounts admin a single package? or does only one account? Have we checked with the ACF guys or other teams to see if there's a "WPE" packagist account?

UPDATE: You can, in fact, add other maintainers.

[colinmurphy]

That said, can multiple accounts admin a single package? or does only one account? Have we checked with the ACF guys or other teams to see if there's a "WPE" packagist account?

UPDATE: You can, in fact, add other maintainers.

That's a good point about checking with ACF guys and also good to know you can other maintainers. I just want to make sure that we don't add the packages for one account and if someone else needed access, that they were not able to access the account.

[colinmurphy]

Another issue we do have is that in our current beta workflow, the changset bot updates the package.json verison (which is correct) but we don't have update our composer version.

We might be able to do this with a bash script possibly running using "version" script in the package.json

[colinmurphy]

@wpengine/headless-open-source

Updated task description with new approach based on feedback.