BellaBuffs with PHPMailer Integration
This is a fork of BullaBuffs, a fanlisting script written in PHP, with PHPMailer powering the email sending functions.
A fanlisting is simply an online list of fans of a subject, such as a TV show, actor, or musician, that is created by an individual and open for fans from around the world to join. There are no costs, and the only requirements to join a fanlisting are your name and country. Fanlistings do not have to be large sites (although some are), they are just a place where you can sign up with other fans.
Description
BellaBuffs includes the optional features to email new members of a fanlisting after submitting the join form, email the fanlisting admin when a new member joins or email new members when their applications were approved. The original BellaBuffs script achieved this by using PHP's built-in mail() function.
This fork replaces the PHP mail() functions from BellaBuffs with PHPMailer, allowing a fanlisting to send out emails with SMTP, provided the fanlisting owner chooses to enable the features to send emails, even if the hosting server does not support the PHP mail() function.
The PHPMailer script that is incorporated in this fork is based on InfinityFree's PHPMailer contact form script. As InfinityFree's free hosting plan does not support PHP mail() function, InfinityFree has provided their contact form script as an alternative.
This BellaBuffs fork has been tested with PHP 8.2, 8.3 and 8.4.
New Features
- Integrate PHPMailer for the email sending features, should the fanlisting owner enables said features.
- Email sending features are enabled by default, but can be disabled in
prefs.php. - HTML5 form validation, including email and URL input types and the
requiredattribute. - Update list of countries.
- Add a buttons folder (with a placeholder file to enable the folder to be pushed via Git), so users do not need to manually create the folder to store uploaded buttons.
- Allows fanlisting members to change their favourites with the update form if the favourites field is enabled.
- Check for
https://in addition tohttp://for potential spam in the comment fields. - Add the option to enable a security question field on the join and contact forms to improve anti-spam measures.
Usage Instructions
- Go to the Releases tab of this repository, download the 7z file of the latest release of BellaBuffs-PHPMailer, then extract the archive.
- Alternately, you can clone this repository, as the files in this repository can be used out of the box.
- Customise your preferences in
prefs.php. - Configure your email SMTP settings in
contactform/config.php. - Upload all files of this fork to a directory where you want your fanlisting to be hosted on.
- Set file permissions of all the
.txtfiles to CHMOD 666 to make the text files writeable. - Set permission of the
buttonsdirectory to CHMOD 777 to enable buttons to be uploaded to the directory. For better security, it is recommended to set the permissions ofbuttonsdirectory to CHMOD 755 when not using the button upload features.
More instructions for using BellaBuffs can be found in the original Read Me of BellaBuffs.
Permissions
You are free to use this BellaBuffs fork and customise it as much as you like. You may credit me for this fork specifically, but it is not required.
However, regardless if you choose to credit me for this fork or not, per the original author Jem Turner's Read Me, you must link back to Jem Turner at https://www.jemjabella.co.uk/. By using BellaBuffs, you also agree not to sell copies of the script, or services relating to the script (i.e. installation, customisation, etc) without written permission of Jem Turner. You can read Jem Turner's original Read Me file here.
Credits
- Jem Turner - The original author of BellaBuffs
- InfinityFree for their PHPMailer contact form script
- PHPMailer