Skip to content

Testing Instructions for Critical Flow

Jump to bottom
Ankit K Gupta edited this page Oct 10, 2025 · 8 revisions

Note: These cases are under WIP.

Plugin Activation Behaviour – Reddit for WooCommerce (Dependency on WooCommerce)

Verify that the Reddit for WooCommerce plugin cannot be activated if WooCommerce is not installed/active, and can be activated successfully when WooCommerce is active.

Steps to Test:

Scenario 1 – WooCommerce Not Installed/Active

  1. Navigate to Plugins → Add New in WordPress admin.
  2. Install the Reddit for WooCommerce plugin from the WordPress.org repository or plugin zip file(but do not install WooCommerce).
  3. Attempt to Activate the Reddit for WooCommerce plugin.

Scenario 2 – WooCommerce Installed and Active

  1. Install and activate the WooCommerce plugin.
  2. Install the Reddit for WooCommerce plugin (if not already installed).
  3. Activate the Reddit for WooCommerce plugin.

Expected Result:

  • Scenario 1:

    • Activation should be blocked.
    • An admin notice/message should appear indicating that WooCommerce is required for Reddit for WooCommerce to function.

  • Scenario 2:

    • Plugin should activate successfully without any errors.
    • Reddit settings/options should appear under Marketing.
Screenshot 2025-09-29 at 4 08 51 PM

Reddit menu should appear under the Marketing tab.

Steps to Test:

  1. Activate the Reddit for WooCommerce plugin.
  2. Navigate to WooCommerce > Marketing in the left admin menu.

Expected Result: A new menu item labelled “Reddit” appears under WooCommerce > Marketing.

Clicking on “Reddit” should open the “Set up your accounts” screen.

Steps to Test:

  1. Go to Dashboard > Marketing in the WordPress admin dashboard.
  2. Click on the “Reddit” card under the Channels section, or click the Reddit menu item under Marketing.

Expected Result:

  • The user is redirected to the “Set up your accounts” screen.
  • This screen provides step-by-step guidance for the merchant to complete the initial configuration, such as connecting a WordPress.com account and a Reddit account.

WordPress.com connection in “Set up your accounts” screen should display a connected status with email after successful connection

Preconditions:

  • WooCommerce and Reddit for WooCommerce plugins are installed and activated.
  • Reddit for WooCommerce plugin is not yet fully configured.

Steps to Test:

  1. Navigate to Marketing in the WordPress admin dashboard.
  2. Click on the Reddit tab Marketing.
  3. On the “Set up your accounts” screen, locate the WordPress.com card.
  4. Click the Connect button on the WordPress.com card.
  5. Follow the authentication and authorization process to connect a WordPress.com account.

Expected Result:

  • After successful connection, the WordPress.com card updates to show:

    • A green checkmark indicating the connection status.
    • The connected WordPress.com account’s email address displayed within the card.

Reddit account connection card in the “Set up your accounts” screen should display account details after successful connection

Preconditions:

  • Reddit for WooCommerce plugin is not yet fully configured.
  • WordPress.com account is already connected.

Steps to Test:

  1. Navigate to Marketing > Reddit in the WordPress admin dashboard.
  2. Click on the Reddit tab.
  3. On the “Set up your accounts” screen, locate the Reddit card.
  4. Click the Connect button on the Reddit card.
  5. Follow the authentication and authorization process to connect your Reddit Business account.

Expected Result:

  • After successful connection, the Reddit Business card updates to show:

    • Emails ID linked to the connected Reddit email ID.
    • Business Name Reddit Business account details.
    • Ads Account ID/name associated with the connected organization.
    • Pixel ID linked to the connected Reddit Ads account.
    • A green checkmark indicating the connection status.

Option “Or, connect to a different Reddit account” should disconnect the current account and allow connecting a new one.

Preconditions:

  • WordPress.com account is connected.
  • Reddit Business account is already connected and displaying Organisation Name, Ads Account, and Pixel ID.

Steps to Test:

  1. On the “Set up your accounts” screen, locate the Reddit Business card showing the connected account details.
  2. Click on 'Edit'.
  3. Click the “Or, connect to a different Reddit account” option.
  4. Follow the process to create a new Business account.

Expected Result:

  • The existing Reddit Business account connection is successfully disconnected.
  • The setup flow prompts the merchant to create a new Reddit Business account.
  • Once the new connection is complete, the Email Id, Business Name, Ads Account, and Pixel ID update to reflect the newly connected account.

Verify functionality for creating a new Business account via “Or, create a new Business account” option

Preconditions:

  • WooCommerce and Reddit for WooCommerce plugins are installed and activated.
  • WordPress.com account is connected.
  • A Reddit Business account is already connected and displayed in the Reddit Business card.

Steps to Test:

  1. On the “Set up your accounts” screen, locate the **Reddit ** card showing the connected account details.

  2. Click on Edit.

  3. Select “Or, create a new Business account” option.

  4. A modal popup should appear with the following confirmation message:

    Create Business Account
Are you sure you want to create a new Business account?
You already have another Business account associated with this Reddit account.

[Yes, I want a new account]   [Cancel]

  5. Click on “Yes, I want a new account.”

Expected Result:

  • The modal should close, and a new browser tab opens.
  • The new tab should display the Reddit interface to create a new Business account.
  • User can proceed with the setup and link this new account to plugin.

Continue button should activate after connecting WordPress.com and Reddit accounts, leading to success modal

Steps to Test:

  1. On the Set up your accounts screen:

    • Connect the WordPress.com account and confirm the green checkmark appears with connected email.
    • Connect the Reddit account and confirm the green checkmark appears with details like, Ads Account, and Pixel ID, etc.

  2. Verify that the Continue button is now active.

  3. Click the Continue button.

Expected Result:

  • The Continue button is enabled only after both accounts (WordPress.com and Reddit) show a connected status with green checkmarks.
  • Clicking Continue navigates to the next screen.
  • A modal appears stating “You’ve successfully set up Reddit for WooCommerce! 🎉” confirming completion of the setup.
Screenshot 2025-09-29 at 5 09 47 PM

Success modal should close when clicking 'X', the 'Close' button, or pressing the Escape key

Steps to Test:

  1. When the success modal appears, click the 'X' icon in the top corner of the modal.

    • Verify the modal closes.

  2. Or click the 'Close' button within the modal.

    • Verify the modal closes.

  3. Or press the Escape key on the keyboard.

    • Verify the modal closes.

Expected Result:

  • In all three cases ('X' icon, 'Close' button, Escape key), the success modal closes and the user is returned to the main screen without breaking layout or losing expected state.

Reddit Catalog Item checkbox behaviour on Product Create and Edit screens

Checkbox should be checked by default when creating a new product

Steps to Test:

  1. Go to WordPress Admin → Products → Add New.
  2. Scroll to the Product data > Reddit section.
  3. Observe the default state of the checkbox.

Expected Result:

  • The Reddit Catalog Item checkbox is visible.
  • The checkbox is checked by default.

Checkbox should be hidden when the Reddit plugin is disabled

Steps to Test:

  1. Go to Plugins in WordPress Admin.
  2. Deactivate the Reddit for WooCommerce plugin.
  3. Go to Products → Add New.
  4. Also check Products → Edit for any existing product.

Expected Result:

  • The Reddit Catalog Item checkbox is not visible on both the Add New Product and Edit Product screens.

Merchant can uncheck the checkbox from the Edit Product screen

Steps to Test:

  1. With Reddit plugin active, create a new product (checkbox should be checked by default).
  2. Save the product.
  3. Go to Products → Edit for the same product.
  4. Uncheck the Reddit Catalog Item checkbox.
  5. Save/Update the product.

Expected Result:

  • The Reddit Catalog Item checkbox remains unchecked after saving.
  • No automatic re-check happens unless manually enabled again.

Verify that a notice is displayed when the user doesn’t have the Catalog Manager role.

Precondition: User account is connected but does not have the Catalog Manager role assigned.

Test Steps:

  1. Log in to the WordPress Admin Dashboard.
  2. Navigate to **Marketing › Reddit › Complete the onboarding flow.
  3. Attempt to create a catalog without having the Catalog Manager role assigned.
  4. Observe the interface for a notice displayed.

Expected Result:

  • A notice should appear with the following message:

    “Your account doesn't have the Catalog Manager role, which is required for catalog creation. Please assign it by going to Your Account › Edit › Member Details & Business Role › Advanced Role here. Once the role is assigned, please click Create Catalog.”

  • The message should be clearly visible and accessible.

  • The user should not be able to proceed with catalog creation until the Catalog Manager role is assigned.

  • The message should include a clear path or guidance to assign the role.

Screenshot 2025-10-10 at 8 36 07 PM

Verify that a notice is displayed when there is an error during catalog creation.

Test Steps:

  1. Log in to the WordPress Admin Dashboard.
  2. Navigate to Marketing › Reddit › Setting Screen .
  3. Attempt to create a catalog, to simulate or trigger an error (change store currency to any non-supported currency, e.g. INR).
  4. Observe the interface for any notice or warning displayed.

Expected Result:

  • A notice should appear with the following message:

    “There was some error creating the Catalog. Please check the logs for more details.”

  • The message should be clearly visible and accessible.

  • The message should guide the user to check logs for details on the issue.

Screenshot 2025-10-10 at 8 42 19 PM

Verify Catalog CSV generation functionalities.

Case-1: Trigger CSV export job after onboarding completion

Test Steps:

  1. Start the Reddit for WooCommerce onboarding process.
  2. Complete all onboarding steps until redirected to the settings page.
  3. Check if the Catalog CSV export job is running.

Expected Result:

  • On reaching the settings page, the Catalog CSV export job should start immediately.

Case-2: Verify recurring job is scheduled after onboarding

Test Steps:

  1. Complete onboarding as in Case-1.
  2. Go to WooCommerce → Status → Scheduled Actions
  3. Search for the Catalog CSV reddit_for_woocommerce_recurring_catalog_export recurring job.

Expected Result:

  • A recurring job for Catalog CSV export should be scheduled with frequency Every 1 day.

Case-3: Recurring schedule is removed after plugin deactivation

Test Steps:

  1. Ensure onboarding is complete and the recurring job is visible in Action Scheduler.
  2. Deactivate the Reddit for WooCommerce plugin from Plugins page.
  3. Check WooCommerce → Status → Scheduled Actions again.

Expected Result:

  • The recurring Catalog CSV job Reddit_for_woocommerce_recurring_catalog_export should be removed from the schedule.

Case-4: Recurring schedule is re-added after plugin reactivation (if onboarding complete)

Test Steps:

  1. Complete onboarding and ensure the recurring job is present.
  2. Deactivate and then reactivate the Reddit for WooCommerce plugin.
  3. Check WooCommerce → Status → Scheduled Actions.

Expected Result:

  • The recurring Catalog CSV job should be re-added with once daily frequency after activation, only if onboarding has already been completed.

Case-5: Verify Snackbar Notice when no products exist and Generate CSV is pressed

Test Steps:

  1. Ensure there are no published products on the WooCommerce site.
  2. Go to the Reddit for WooCommerce settings page.
  3. Locate and click the Generate CSV button.

Expected Result:

  • A Snackbar notice should appear at the bottom of the screen (as shown in the reference image).
  • The notice should clearly inform the user that there are no products available for CSV generation.
  • No CSV generation process should start.
Screenshot 2025-09-29 at 5 54 17 PM

Case-6: Generate CSV when products are available

Test Steps:

  1. Ensure there is at least one published product in the WooCommerce store.

  2. Go to the Reddit for WooCommerce settings page.

  3. Click the Generate CSV button.

Expected Result:

  • A message appears: "We’re generating your CSV file… This may take a few seconds."

  • The CSV generation process should start immediately.

  • No error or warning messages should be displayed.

  • Once completed, it should show a message like "Last exported on Date & Time."

Screenshot 2025-09-29 at 5 57 58 PM Screenshot 2025-09-29 at 5 56 16 PM

Case-7: Verify Product Catalogue sync in Reddit Dashboard

Steps to Test:

  1. Log in to the Reddit Ads Dashboard with the connected Reddit Business account.
  2. Navigate to the Catalogs section.
  3. Locate the synced catalog associated with the WooCommerce store.
  4. Verify that the Catalog name matches the WooCommerce store name.

Expected Result:

  • The product catalog should appear in the Product Catalogs section.

  • The catalog should display the following details correctly:

    • Name – Matches the WooCommerce store name.
    • Catalog Health – Shows sync/health status.
    • Products – Total number of synced products.
    • Rejected Products – Count of products rejected by Reddit.
    • Approved Products – Count of successfully approved products.
    • Last Updated – Shows the most recent sync date/time.
Screenshot 2025-09-29 at 6 12 12 PM

Verify Reddit Pixel Tracking Events on WooCommerce Store

Step No. Test Steps Expected Result
1 Open the store homepage. Reddit Pixel Helper should show PageVisit event fired.
2 Navigate to any Single Product Page. Reddit Pixel Helper should show ViewContent event fired with parameters:• id (Product id)• name (product name)
3 Click Add to Cart for the product. Reddit Pixel Helper should show AddToCart event fired with parameters:• itemCount, value, currency, products id, product name
4 Proceed to checkout and place an order successfully. Reddit Pixel Helper should show Purchase event fired with parameters:• price (Total order value)• currency• conversionId• product's id and name, itemCount
Recording.1439.mp4

Verify Conversion Tracking via Conversions API

Steps:

  1. Conversion tracking is enabled in Reddit > Settings > Track Conversions.
  2. Test customer account is available for placing an order.
  3. Add the following line in wp-config.php to log API responses locally:
define( 'REDDIT_FOR_WOOCOMMERCE_DEBUG', true );
  1. Check log under WooCommerce > Status > Logs > plugin-reddit-for-woocommerce.

Steps to Test & Expected Results

Step No. Test Steps Expected Result (Event Payload Example)
1 Open the store Homepage. PageVisit event is logged with metadata. Example: json { "event_at": "2025-09-02T12:29:45+00:00", "event_type": { "tracking_type": "PageVisit" }, "event_metadata": { "conversion_id": "473b283a-b4ee-4de6-88f8-6bc6b5b9439b" }, "user": { "ip_address": "xxx", "user_agent": "xxx", "uuid": "from _rdt_uuid cookie" } }
2 Navigate to a Single Product Page. ViewContent event is logged with product details. Example. json { "event_type": { "tracking_type": "ViewContent" }, "event_metadata": { "conversion_id": "83fc5f55-7379-4fb8-830c-f4c9c39d0872", "products": [ { "id": "60", "name": "Simple Product" } ] }, "user": { "uuid": "from _rdt_uuid cookie" } }
3 Click Add to Cart. AddToCart event is logged with cart data. Example json { "event_type": { "tracking_type": "AddToCart" }, "event_metadata": { "conversion_id": "83fc5f55-7379-4fb8-830c-f4c9c39d0872", "item_count": 1, "value_decimal": 14, "currency": "USD", "products": [ { "id": "60", "name": "Simple Product" } ] }, "user": { "uuid": "from _rdt_uuid cookie" } }
4 Complete Checkout and place an order. Purchase event is logged with order details. Example json { "event_type": { "tracking_type": "Purchase" }, "event_metadata": { "conversion_id": "wc_order_fNJwU8EPw9J3S", "item_count": 3, "value_decimal": 314, "currency": "USD", "products": [ { "id": "60", "name": "Simple Product" }, { "id": "62", "name": "Variation Product - Red" } ] }, "user": { "uuid": "from _rdt_uuid cookie" } }
Recording.1440.mp4
Recording.1441.mp4
Clone this wiki locally