feat(ugc): automated WC products for self-serve listings

[dkoo]

All Submissions:

• Have you followed the Newspack Contributing guideline?
• Does your code follow the WordPress' coding standards and VIP Go coding standards?
• Have you checked to ensure there aren't other open Pull Requests for the same update/change?

Changes proposed in this Pull Request:

Takes the first step toward self-serve listings with some automated WooCommerce products to help facilitate single purchase or subscription-based listings.

The following products are included to start, but all of these are subject to change based on publisher feedback. The default prices and planned behavior are also subject to change pending publisher feedback.

• Single Listing: Users can purchase a single listing of any type (Event, Generic, Marketplace, or Place).
  • Intended behavior (not yet implemented): Once a user purchases a single listing, they can edit their listing in the block editor and submit it for editorial review. Once approved and published by a staff member, the listing is live for 30 days. If they want to extend the life of the listing, the user can purchase another single listing and resubmit the same listing or create a new listing, or purchase a subscription.
• Monthly Subscription: Users can purchase a monthly subscription. This entitles the user to a single listing of any type which will be live for the duration of the subscription.
  • Intended behavior (not yet implemented): The subscription should have a minimum purchase period of 6 months (or 1 year?). The single listing tied to their subscription purchase is considered the user's "primary" listing. They may make purchases of single listings during their subscription to publish additional listings which will remain live during the subscription period. These listings are associated with the primary listing via the Related Content feature.
• Add-on: Featured Listing: This is an optional add-on which can be applied to either a single listing or a subscription at the point of purchase only.
  • Intended behavior (not yet implemented): Purchasing this will apply "featured" status to the primary listing item created during checkout. The Featured status will remain as long as the primary listing is live. For subscriptions, this will charge an additional monthly fee for the duration of the subscription.
• Add-on: Premium Subscription: This is an optional add-on which can be applied to a subscription.
  • Intended behavior (not yet implemented): This product will let the subscriber create up to five (subject to change) additional listings of any type per month of active subscription, all of which are associated with the user's primary listing via Related Content, and all of which will receive Featured status for 30 days after publishing.

Note: Taking a cue from the long/ongoing projects in Newspack Plugin, I'm going to start pushing smaller, partial functionality to master for the larger self-serve/UGC listings milestone. Because it's incomplete and not fully tested, this functionality will be gated behind a WP config constant NEWSPACK_LISTINGS_DEV_MODE, so unless this constant is defined and true, these PRs shouldn't behave any differently compared to master.

How to test the changes in this Pull Request:

1. After checking out this branch, plugin behavior at first should be unchanged from master.
2. Ensure you have WooCommerce and its Subscriptions extension active.
3. Add define( 'NEWSPACK_LISTINGS_DEV_MODE', true ); to your wp-config.php.
4. After adding the environment constant, visit the Products menu in WP admin.
5. Confirm that the following products have been automatically generated by the plugin:

6. Go to Listings > Settings in WP admin. Confirm that the settings page is now divided into several sections, with a new "Self-Serve Listings" section at the bottom:

7. Update the price values of these settings and save. Confirm that in the WooCommerce Products menu, the prices of each product is automatically updated to match Listings plugin settings.
8. Temporarily deactivate WooCommerce and confirm that the Listings plugin continues to work, but without the additional "Self-Serve Listings" settings. Note that the Listings products will not be deleted if the Listings or WC plugins are deactivated, so that we don't lose purchase histories in that event.

Other information:

• Have you added an explanation of what your changes do and why you'd like us to include them?
• Have you written new tests for your changes, as applicable?
• Have you successfully ran tests with your changes locally?

[adekbadek]

Works as expected, left some suggestions.

[matticbot]

🎉 This PR is included in version 2.5.0-alpha.1 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

[matticbot]

🎉 This PR is included in version 2.5.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀