Ticket-agnostic cart

[JPry]

🎫 Ticket

ET-2200

🗒️ Description

This PR updates the cart component to be able to handle non-ticket items (e.g. an agnostic cart).

The main changes are:

• Create a new class \TEC\Tickets\Commerce\Cart\Agnostic_Cart, which implements the Cart_Interface interface.
• A new class \TEC\Tickets\Commerce\Cart\Cart_Item was created to handle the cart items. This class implements ArrayAccess with a few additional methods, and an assurance of some common properties.
• The new Agnostic_Cart class becomes the default cart class (see \TEC\Tickets\Commerce\Cart::get_repository()).
• The Agnostic_Cart class has its own unit test suite similar to the Unmanaged_Cart suite to ensure it works as expected.
• Except for tests, wherever we referenced the prior cart class, Unmanaged_Cart, we should now be referencing Cart_Interface instead.
• A number of methods from the Unmanaged_Cart class were moved over to the Abstract_Cart parent class.
• Some of the logic for whether an item can be added to the cart was moved to the Tribe__Tickets__Tickets_Handler class.
• Within the get_cart_total() and get_cart_subtotal() methods, I implemented logic to prevent unnecessary duplicate calculations. During the process of working through this code, I discovered that the get_cart_total() method is called over 30 times within a single request, and the old logic allowed for those calculations to be performed fresh each time, even if the cart contents had not changed. This new logic handles when the cart contents have changed, and will ensure calculations are updated afterwards.
• The Abstract_Cart::get_items_in_cart() and Commerce\Cart::get_items_in_cart() methods have been updated to allow getting items of a particular type, or all items. The default behavior is to only get ticket items to preserve the current functionality in other places without needing to modify everything within this PR.

Template file updates:

• src/views/v2/commerce/checkout/cart/ticket.php - I added this file to handle the display of ticket items in the cart.
• src/views/v2/commerce/checkout/cart/items.php - This template file was updated to handle the display of ticket vs. non-ticket items. For the time being, the old item.php tempalte is identical to the ticket.php template, but now it will be easy to handle the display of non-ticket items in the cart.

There are some new hooks added:

• tec_tickets_commerce_cart_cookie_expiration filter - allows filtering the cookie expiration time for the cart.
• tec_tickets_commerce_cart_repo_prepare_data filter - allows filtering the data within the cart repository class (e.g. inside Abstract_Cart::prepare_data()).
• tec_tickets_commerce_cart_process action - allows access to the cart object and the $data array within the process() method. This is where additional types of items can be hooked into the cart.
• tec_tickets_commerce_cart_add_full_item_params filter - allows filtering the full item parameters before calculations are performed.
• tec_tickets_commerce_cart_transient_expiration filter - allows filtering the transient expiration time for the cart.

There are some hooks that were deprecated:

• tec_tickets_commerce_cart_expiration - use tec_tickets_commerce_cart_cookie_expiration instead.

🎥 Artifacts

✔️ Checklist

• Ran npm run changelog to add changelog file(s). More info here
• Code is covered by NEW wpunit or integration tests.
• Code is covered by EXISTING wpunit or integration tests.
• Are all the required tests passing?
• Automated code review comments are addressed.
• Have you added Artifacts?
• Check the base branch for your PR.
• Add your PR to the project board for the release.

[JPry]

Methods and properties removed from this class were added to the Abstract_Cart class.

[JPry]

This was added to ensure the method behaves as indicated by the interface.

[Camwyn]

comment

[Camwyn]

request changes

[Camwyn]

Ignore the rando comment/request/approval above. Jeremy and I were testing something.