Thank so much for purchasing our ePubFan, with hot features
ePubFan is designed to work on Apache system with mod_rewrite. But you can run with other systems easily, such as nginx, lighttpd, litespeed, ect. by converting htaccess's rewrite rules to other suitable rules of these systems.
Your server must support MySQLi because ePubFan only works with it.
ePubFan must be operated by an MySQL server, at least 5.5
By default, ePubFan is installed with Development Mode is OFF, in order to enable this mode, please open
"your/path/to/ePubFan/common.php" and change
With Development Mode is ON, there are few rules you should notice:
- All PHP errors displayed to all end users, and still logged into the file "errors.log"
- Many very important tasks are disabled, such as: change super administrative account's password & email
By default, ePubFan uses PHP
mail() function to send emails to users for tasks such as: new registrations, payments, password changes, etc.
But ePubFan is also implemented PHPMailer as alternation. And it's super easy to set PHPMailer as default mailing function, by using your GMail or Yahoo Mail accounts. In order to perform this task, please follow these 2 very simple steps:
PSZMailer.settings.php, then open this renamed PHP file.
Fill your account details into
$PSZMailer_settingthen Save changes
<?php $PSZMailer_setting = array( 'username' => 'email@example.com', 'password' => 'your-password' ); ?>
- From now, all emails will be sent by your GMail / Yahoo Mail account by default.
CAUTION you'll need to switch "Less secure apps" to ON if you're using GMail.
By default, ePubFan displays the dropdown select of supported languages on both frontpage (homepage) and application page. In order to add / remove a supported language, please open
"your/path/to/ePubFan/common.php" & edit variable
Because ePubFan is a PHP script, so we need an already installed PHP web-host that working well. Basically, you'll not need MySQL to run ePubFan.
Local Development / Test
It's better & faster to test ePubFan on local machine enviroments. This section guides you how to create an enviroment that may run ePubFan look like a real live system. In this tutorial, we may only give you the instructions to create a system on Windows OS and we also assume your desired domain is
yourdomain.com. For other OS, please find different solutions, it's also very easy.
Basically, you may use any package that you're fimiliar with; it only needs to pass Requirments. In this tutorial, we suggests XAMPP, certainly you may also download the latest version, but stable version 5.6 is recommended. This package comes with all required softwares: Apache, PHP & MySQL.
After downloading & installing XAMPP successfully (we assume you installed to
C:\xampp\), without errors. Please go to next step.
CAUTION for any errors, please Google it, we can not give exacted solution because of your computer.
You need administrative permission to edit the hosts file
C:\Windows\System32\drivers\etc\hosts. But we recommend this tool - BlueLife Hosts Editor - to edit quickly. Please download & verify its checksum to prevent any harm.
Run this tool with administrative permission, then add a record for domain you want to run with this script. You may choose any IP address. After added this record, Save it then close.
CAUTION purpose of this step is pointing your desired domain to local IP on your computer, next step we'll assign a site with this domain on your local server.
1) Open Apache vhost configuration file
C:\xampp\apache\conf\extra\httpd-vhosts.conf, add code below to end of file then save. Use the same IP address & desired domain you declared in above step.
<VirtualHost 127.0.0.20> DocumentRoot c:/xampp/htdocs/yourdomain.com ServerName www.yourdomain.com ServerAlias * </VirtualHost>
2) Unzip all files in folder
C:\xampp\htdocs\yourdomain.com\. If this folder is not exist, create it first.
3) Must restart Apache to apply new settings, by using the tool -
Type your desired domain
yourdomain.com into browser's address bar then start installation to test.
How it work
- Browser uses your hosts file
C:\Windows\System32\drivers\etc\hoststo resolve this domain first
- Found this domain with IP of server that contains this site, then send request to server (your local machine)
- Your local server (XAMPP) receives request, use
httpd-vhosts.confto check if this IP address is hosting on server
- Found this IP address is listening, and hosted on server, start serving all requests
ePubFan's Localization is really very simple & easy. You even do not need any tool except a text editor, because ePubFan uses PHP language files for showing the text. ePubFan has a default language file (
us.php) in languages directory, you only need to translate all strings to other languages easily & quickly.
For more new other strings, it's also easy, just follow our instructions in ePubFan's Multilingual support to manage ePubFan's languages better.
SPECIAL you just put the translated language PHP file into the languages directory, the platofrm shall care the rest.