Messenger Package Installation Documentation

Follow these steps to install the independent Messenger package located in /api-addon-messangr, then activate it with a valid Messenger purchase code.

Open Messenger Installer Get a License

Messenger Package Separate Addon

1. Requirements Before Installation

PHP 8.0 or higher The installer checks the PHP version before allowing the install action to run.

Required PHP extensions curl and json must be enabled for license verification and Messenger API payloads.

Messenger package files The package folder must exist in your Sngine root directory as /api-addon-messangr.

Messenger license This package accepts only the valid Messenger product license.

Sticker assets The default sticker catalog requires /api-addon-messangr/assets/stickers and /api-addon-messangr/seeders/stickers.php.

Admin access You must sign in with an account that can manage Messenger package settings.

2. Installation Steps

Upload or copy the Messenger package folder into the Sngine root directory. The final path should look like /www/wwwroot/your-domain.com/api-addon-messangr.
Make sure your main Sngine website is working normally before installing the Messenger package.

Open the Messenger installer in your browser:

https://your-domain.com/api-addon-messangr/install.php

Sign in with a site administrator account if the installer redirects you to the Messenger admin sign-in page.
Review the environment checks. All checks must pass before the install button can be used.
Enter the Messenger Purchase Code from Flutter Crafters Store. The license must belong to the Messenger package.
Run the installer. It will verify the purchase code, activate it for the current domain when needed, then run Messenger storage migrations.
After a successful installation, open the Messenger admin area:
```
https://your-domain.com/api-addon-messangr/admin/index.php
```

Important: the Messenger package is separate from api-addons. It keeps its own settings, chat tables, backgrounds, stickers, stories, and license state inside api-addon-messangr.

3. How to Get a Messenger License

Open Flutter Crafters Store:
```
https://store.fluttercrafters.com/
```
Create a new account with Sign Up, or log in with Sign In.
Open the Messenger product page and choose the license option that fits your use case.
Click Add to Cart or Buy Now, then complete the payment.
After the order is complete, open your store account and go to your purchases or downloads section.

Copy the product Purchase Code, then paste it into:

https://your-domain.com/api-addon-messangr/install.php

Use the same domain that the Messenger app will connect to. The license is activated and bound to the current domain during installation.

4. After Installation

Open the Messenger admin home from /api-addon-messangr/admin/index.php.
Open app settings from /api-addon-messangr/admin/app-settings/index.php and confirm the license status is active.
Manage chat backgrounds from /api-addon-messangr/admin/backgrounds/index.php.
Manage sticker packs and sticker assets from /api-addon-messangr/admin/stickers/index.php.
Test the Messenger settings endpoint: https://your-domain.com/api-addon-messangr/app/settings.
Test the basic health endpoint: https://your-domain.com/api-addon-messangr/ping.
For future updates, use: https://your-domain.com/api-addon-messangr/update.php.

5. Troubleshooting

Wrong product The purchase code does not belong to the Messenger package. Use a valid Messenger license.

Domain mismatch The purchase code is already activated on another domain. Use a new code or contact support if your license terms allow moving the activation.

Sticker seeding failed Check that seeders/stickers.php and assets/stickers exist inside api-addon-messangr.

PHP check failed Upgrade your server PHP version to 8.0 or higher.

curl or json check failed Enable the missing PHP extension from your server control panel, then reload the installer.

Admin redirect loop Sign in from /api-addon-messangr/admin/signin.php with an account that can manage Messenger settings.