Enhanced Onboarding using MICE by sol-loup · Pull Request #2896 · facebook/facebook-for-woocommerce

sol-loup · 2025-02-24T20:40:41Z

MICE-4 Branch Changes Summary

Overview

Implements Meta Integrated Commerce Extension (MICE) for Facebook for WooCommerce.

Key Changes

New MetaExtension Handler (includes/Handlers/MetaExtension.php)
- REST API endpoints for MICE communication
- Token management and settings storage
- iframe URL generation
Enhanced Connection Screen (includes/Admin/Settings_Screens/Connection.php)
- iframe-based onboarding flow
- Message handler for iframe communication
- Event processing for MICE
Unit Tests
- ConnectionTest.php and MetaExtensionTest.php

Technical Details

REST endpoints:
- /wp-json/wc-facebook/v1/update_fb_settings
- /wp-json/wc-facebook/v1/uninstall
Settings stored in WP options with wc_facebook_ prefix

How to Enable

The feature is disabled by default. To enable, modify the use_enhanced_onboarding() method in facebook-commerce.php:

// Line 3029 in facebook-commerce.php
public function use_enhanced_onboarding() {
    return true; // Change from false to true
}

Testing

UI Flow

WooCommerce marketing icon → Facebook → Connections tab
Onboard through MBE
Verify MICE management page appears

Technical Testing

./vendor/bin/phpunit --filter "ConnectionTest|MetaExtension"

Expected Behavior

iframe loads and resizes dynamically
Settings save after connection
Management interface displays post-connection
Uninstall clears settings

Preliminary diff (using some Magento public primitives) allowing MICE Splash Page to be loaded in WooC Extension Next steps: 1. Implement token storage 2. Implement MICE Management page

…st for easier testing.

…data

facebook-github-bot · 2025-02-25T21:01:48Z

@sol-loup has imported this pull request. If you are a Meta employee, you can view this diff on Phabricator.

facebook-github-bot · 2025-02-25T21:53:15Z

@sol-loup has updated the pull request. You must reimport the pull request before landing.

…tently vend a URL

facebook-github-bot · 2025-02-27T00:26:30Z

@sol-loup has updated the pull request. You must reimport the pull request before landing.

facebook-github-bot · 2025-02-27T22:50:14Z

@sol-loup has updated the pull request. You must reimport the pull request before landing.

facebook-github-bot · 2025-03-06T00:27:50Z

@sol-loup has updated the pull request. You must reimport the pull request before landing.

Updating some MBE params used by MiCE solution

facebook-github-bot · 2025-03-06T01:01:06Z

@sol-loup has updated the pull request. You must reimport the pull request before landing.

facebook-github-bot · 2025-03-06T19:02:09Z

@sol-loup has updated the pull request. You must reimport the pull request before landing.

facebook-github-bot · 2025-03-06T21:57:50Z

@sol-loup has imported this pull request. If you are a Meta employee, you can view this diff on Phabricator.

facebook-github-bot · 2025-03-06T22:14:17Z

@sol-loup has updated the pull request. You must reimport the pull request before landing.

facebook-github-bot · 2025-03-06T22:16:18Z

@sol-loup has imported this pull request. If you are a Meta employee, you can view this diff on Phabricator.

facebook-github-bot · 2025-03-06T23:08:13Z

@sol-loup has updated the pull request. You must reimport the pull request before landing.

facebook-github-bot · 2025-03-06T23:09:13Z

@sol-loup has imported this pull request. If you are a Meta employee, you can view this diff on Phabricator.

facebook-github-bot · 2025-03-06T23:18:15Z

@sol-loup has updated the pull request. You must reimport the pull request before landing.

facebook-github-bot · 2025-03-06T23:18:28Z

@sol-loup has imported this pull request. If you are a Meta employee, you can view this diff on Phabricator.

facebook-github-bot · 2025-03-07T00:43:50Z

@sol-loup merged this pull request in a1f144e.

sol-loup added 12 commits February 10, 2025 16:45

- Adding support for MICE IFRAME in the WooC Extension

62c5b39

Preliminary diff (using some Magento public primitives) allowing MICE Splash Page to be loaded in WooC Extension Next steps: 1. Implement token storage 2. Implement MICE Management page

- Adding support for MICE IFRAME in the WooC Extension

9564eb4

Preliminary diff (using some Magento public primitives) allowing MICE Splash Page to be loaded in WooC Extension Next steps: 1. Implement token storage 2. Implement MICE Management page

Changing iframe connection setting to use a function instead of a con…

afa1975

…st for easier testing.

Adding new rest endpoints to capture locally stored token and config …

0852358

…data

restoring css

24bd466

Merge branch 'MICE' into MICE-2

d57b78e

Adding functionality to render the management page view

8f62598

Fleshing out calls, ensuring correct gating of logic

5ae6adc

Merge branch 'main' into MICE

b573527

Merge branch 'MICE' into MICE-2

715a1f8

Merge branch 'MICE-2' into MICE-3

d96d149

Adding tests for URL generation and connection

2d23d6f

facebook-github-bot added the CLA Signed label Feb 24, 2025

sol-loup added 14 commits February 24, 2025 12:51

Applying correct lint fixes

f1bc045

Merge branch 'MICE' into MICE-2

a6b44ad

Fixing further lint complaints

52f2ccb

Merge branch 'MICE' into MICE-2

21443f5

lint fixes

dfa081e

Merge branch 'MICE-2' into MICE-3

a2eb24c

Fixing lint complaints

9119701

Merge branch 'MICE-3' into MICE-4

48cb21b

Additional test cases and fixes

6ec376e

Merge branch 'main' into MICE

6348c57

Merge branch 'MICE' into MICE-2

9a3e70e

Merge branch 'MICE' into MICE-3

ae2ba7c

Merge branch 'MICE-2' into MICE-3

a77ec3e

Merge branch 'MICE-3' into MICE-4

101ee06

Fixing remaining lint issue

b6a31b8

sol-loup closed this Feb 26, 2025

sol-loup reopened this Feb 26, 2025

Updating tests; changing implmentation of iframe generation to consis…

e3827c3

…tently vend a URL

sol-loup changed the title ~~MICE 4~~ Enhanced Onboarding using MICE Feb 27, 2025

Merge branch 'main' into MICE-4

cdb2391

carterbuce and others added 4 commits February 28, 2025 20:21

Merge branch 'main' into MICE-4

ea2b40d

fix multisite behavior

792d304

Update some params for the MiCE usecase

a0e01b8

Formatting fixes for multi-site

0b08569

Merge pull request #2925 from facebook/MICE-4-param-update

d0aa0ce

Updating some MBE params used by MiCE solution

Addressing vink comments

6b8ba81

Merge branch 'main' into MICE-4

805ce90

Adding more comprehensive test for management url generation

e072b0b

final comment fixes

78e3c59

facebook-github-bot closed this in a1f144e Mar 7, 2025

facebook-github-bot added the Merged label Mar 7, 2025

Conversation

sol-loup commented Feb 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

MICE-4 Branch Changes Summary

Overview

Key Changes

Technical Details

How to Enable

Testing

UI Flow

Technical Testing

Expected Behavior

Uh oh!

facebook-github-bot commented Feb 25, 2025

Uh oh!

facebook-github-bot commented Feb 25, 2025

Uh oh!

facebook-github-bot commented Feb 27, 2025

Uh oh!

facebook-github-bot commented Feb 27, 2025

Uh oh!

facebook-github-bot commented Mar 6, 2025

Uh oh!

facebook-github-bot commented Mar 6, 2025

Uh oh!

facebook-github-bot commented Mar 6, 2025

Uh oh!

facebook-github-bot commented Mar 6, 2025

Uh oh!

facebook-github-bot commented Mar 6, 2025

Uh oh!

facebook-github-bot commented Mar 6, 2025

Uh oh!

facebook-github-bot commented Mar 6, 2025

Uh oh!

facebook-github-bot commented Mar 6, 2025

Uh oh!

facebook-github-bot commented Mar 6, 2025

Uh oh!

facebook-github-bot commented Mar 6, 2025

Uh oh!

facebook-github-bot commented Mar 7, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

sol-loup commented Feb 24, 2025 •

edited

Loading