README

Description

Facebook adds a small Enso integration layer for Facebook page and domain-verification settings.

The package stores a single settings record, exposes a settings form under the Integrations area, and supports environment-level overrides for the verification code and page ID. It also contains a manual upgrade class for removing legacy table columns when the integration moves to environment-based configuration.

It is a lightweight settings package rather than a full Facebook API client.

Installation

Install the package:

composer require laravel-enso/facebook

Run the package migrations:

php artisan migrate

Optional publish:

php artisan vendor:publish --tag=facebook-config

Default configuration:

return [
    'verificationCode' => env('FACEBOOK_VERIFICATION_CODE'),
    'pageId' => env('FACEBOOK_PAGE_ID'),
];

Environment configuration takes precedence over database values returned by the settings model.

Features

• Settings record for page ID and verification-code management.
• Settings endpoints under integrations.facebook.settings.
• Config-based overrides for runtime access.
• Manual upgrade helper for removing deprecated database columns.

Usage

Use the settings model to resolve current integration values:

use LaravelEnso\Facebook\Models\Settings;

$pageId = Settings::pageId();
$verificationCode = Settings::verificationCode();

When present, FACEBOOK_PAGE_ID and FACEBOOK_VERIFICATION_CODE override the persisted values.

API

HTTP routes

• GET api/integrations/facebook/settings
• PATCH api/integrations/facebook/settings/{settings}

Route names:

• integrations.facebook.settings.index
• integrations.facebook.settings.update

Upgrade helper

• LaravelEnso\\Facebook\\Upgrades\\DeprecateFacebookTableColumns

Behavior:

• runs manually
• removes the legacy page_id and verification_code columns from facebook_settings

Depends On

Required Enso packages:

• laravel-enso/core ↗

Companion frontend package:

• @enso-ui/facebook ↗

Contributions

are welcome. Pull requests are great, but issues are good too.

Thank you to all the people who already contributed to Enso!