Sngine Addon — Documentation
Smart-Match helps your community discover meaningful connections by notifying existing members when a newly registered member shares relevant education or workplace information.
Important: Sngine's Education and Work features must be enabled from your website's Admin Panel for the corresponding Smart-Match features to work correctly.
The addon package contains the required files, configuration components, database setup file, settings integration files, and email template. Follow the installation steps below in order.
install.sql mn-cron.php mn-worker.php mn-user-settings.php mn-admin-settings.php user-smart-match.txt admin-smart-match.txt template-loader.php templates/
You do not need to modify the addon files unless specifically instructed in this documentation. Most installation steps only require uploading files, importing the database setup, and adding the provided settings blocks to your Sngine theme.
Extract the downloaded package and upload the
smart-match folder into your
existing Sngine addons directory.
addons folder
Upload the provided addons
folder to your Sngine installation.
addons folder
Upload only the smart-match
folder into your existing addons
directory.
Back up your existing Smart-Match folder first. Then replace the old addon files with the files from the new version.
Open phpMyAdmin, select the database used by your Sngine installation,
and import the included
install.sql file.
The database setup is required for Smart-Match to operate. Do not manually create or rename the tables.
If this is a brand-new installation and your website already has existing members, follow the initialization instructions supplied with your addon package before enabling the scheduled tasks.
This step prevents Smart-Match from processing your existing members as newly registered members during the first run.
Smart-Match uses your existing Sngine email configuration. No separate SMTP configuration is required for the addon.
Go to:
Admin Panel → Settings → Email / SMTP
If your Sngine installation can already send emails successfully, Smart-Match can use the same configuration.
Add the supplied settings blocks to the corresponding Sngine template files.
| Provided File | Theme Template |
|---|---|
user-smart-match.txt
|
themes/[theme]/templates/settings.notifications.tpl
|
admin-smart-match.txt
|
themes/[theme]/templates/admin.settings.notifications.tpl
|
If your website uses multiple themes, repeat this step for each active theme where the Smart-Match settings should appear.
Smart-Match includes a security key for its scheduled tasks. Before creating the cron jobs, replace the placeholder security value included in the addon files with your own unique secret.
| File | Action |
|---|---|
mn-cron.php
|
Replace the placeholder security value. |
mn-worker.php
|
Use the same security value. |
Use the same secret value in both files. Choose a long, difficult-to-guess value and do not publish or share it.
Smart-Match requires two scheduled PHP tasks. For most websites, running both tasks once every minute is recommended.
| File | Purpose |
|---|---|
mn-cron.php
|
Processes Smart-Match activity. |
mn-worker.php
|
Processes queued email notifications. |
Example PHP cron command:
/usr/bin/php /home/account/domains/your-website.com/public_html/addons/smart-match/mn-cron.php /usr/bin/php /home/account/domains/your-website.com/public_html/addons/smart-match/mn-worker.php
Replace the example hosting path with the correct path for your own website. The exact PHP executable path may differ between hosting providers.
If you are using cPanel, Hostinger, Plesk, DirectAdmin, or another hosting control panel, check your hosting provider's documentation for instructions on creating cron jobs.
Need help with installation or setup? Contact me for installation assistance.
Smart-Match includes an editable HTML email template that allows you to customize the appearance of match notification emails.
| File | Purpose |
|---|---|
templates/match-notification.html
|
Match notification email design. |
You can customize the visual design, text, and branding of the
email. Do not remove or rename the template placeholders enclosed
in {{ }}.
Smart-Match uses information already available through Sngine's education and workplace profile features to help members discover relevant connections.
Smart-Match works with the information entered into the relevant Sngine profile fields. For the best results, encourage members to complete their education and workplace information accurately.
Smart-Match provides separate controls for individual members and website administrators.
Need help installing Smart-Match, configuring your website, or troubleshooting an issue? Get in touch.