BoxBilling a free billing & client management software
BoxBilling is a free billing & client management software
Supports automated billing, invoicing, product provisioning
Automatically create hosting accounts as soon as the payment is received
Suspend when account becomes overdue, terminate when a specified amount of time passes.
Enable multiple currencies, accept one time and recurring payments
Boxbilling is perfectly created to sell
Shared and reseller hosting accounts
Domains
Software licenses
Downloadable products
Custom recurrent billing products
Helpdesk, knowledge base, news and announcements system.
Intuitive Web 2.0 AJAX powered interface with 100% usability score!
Invoicing
Use BoxBilling just for issuing invoices for your clients without any product setup.
Perfect for companies to issue custom invoices, notify client and collect money.
Define custom invoice lines and select taxes
Every invoice can have custom taxation rule
Track invoice refunds
Allow your clients pay in their currency and track profit in your currency
Automation
Product creation for hosting accounts, domains, licenses, and downloadable products can be done automatically after the successful payment is received or even with no payment received.
Product creation can be also executed after the administrator approval.
Order can be automatically suspended is no payment was received for X days and unsuspended as soon the late payment will be collected.
Client area password can be automatically reset without the by the client itself.
Control panel password can be reset by the client itself without need to logon on to control panel (depends on server manager used).
Payment reminders can be configured to be sent until the order will be terminated or late payment will be collected.
A custom event hook script can be executed on order activation / suspension / reactivation / cancellation so you can setup custom products easily and interrupt workflow as you need
Support system
Integrated helpdesk allows you to communicate with clients easily.
Multiple helpdesk departments are supported so requests can be distributed through along your staff.
Knowledgebase suggestions are automatically displayed for your customers so they can get some question answered even without need to open a ticket.
Predefined replies can be inserted by the click of mouse and supports system, order and client details variable parsing. That saves a lot time for you and allows sending personalized predefined answers.
News & Announcements system allows you to inform your clients about what is going at the moment and notify about upcoming events.
Knowledgebase allows defining the answers for the most frequency asked questions.
Web Hosts Ready
Easy server setup: provide IP, server type, username / password combination and everything else such as account creation will be done automatically.
Server access roles: BoxBilling will work perfectly no matter if you have root access or just a reseller account.
Disk space, bandwidth, additional features and function can be fully customized for each hosting plan.
Full integration and automation is available with BoxBilling extensions, such as cPanel, Plesk, Directadmin and others.
Even if your hosting control panel is not supported you can use BoxBilling to track your orders and clients, just processes account creations / terminations on your server side manually.
Powerful API
BoxBilling modular architecture is backed by REST API. No matter which interface you are using, BoxBilling template file, JavaScript, PHP or any other you always call the same API.
Every BoxBilling module seamlessly extends API, so that all new features created can be accesed from mobile or any other devices.
To avoid API floods requests per time span limits can be easily defined.
Custom Look & Feel
Every theme is open source
Even this site is simply a custom BoxBilling theme
Templates are powered by Twig templating engine
Designers are not limited to system because all templates have access to powerful BoxBilling API
Intuitive and user friendly interfaces is what we what your clients to experience
Every product type has its own order form design for best user experience
Modular system
BoxBilling is designed to be extended
Create your custom extensions
Contribute extensions to community
Multilanguage interface
Client area can be translated in to any language.
Latest version
Version: 2.7.4
Size: 5.89 MB
Released: 2012-07-04
Download Billing Box
System requirements
Environment on which you are going to install BoxBilling should meet these prerequisites:
Linux OS
PHP Version 5.2.4 or later with extensions
PDO MySQL
curl
mbstring
zlib
ftp
gettext
MySQL Version 4.1.* or later
IonCube 3.1 (or greater) loaders
Apache mod_rewrite module enabled, for SEO urls only
It is recommended to install BoxBilling on VPS server with APC cache enabled for best performance and security reasons.
Installation guide¶
To start BoxBilling installation download latest version from download page
After download is complete extract all files on your computer and upload them via FTP to your server.
Using web installer
Web installer is a convenient way to install BoxBilling and it should be used in most cases. This guide is based assuming that you have uploaded all files to subfolder billing
Access installation setup via the browser, by opening 1&1 Internet - Home
You will need to tick “I agree to the license†to continue the installation.
In the next screen a “Pre-Installation check†will recheck if the system (hosting account) does meet the minimum requirements for installation. Most often you will need to login to your account via a file manager (or FTP manager) and set the required permissions (chmod 777) on these files and folders.
In the next step you will need to setup access to the MySQL database. Enter an existing database and user (with all permissions granted). If you have any trouble setting up a MySQL database and user, please consult your hosting provider. For example, if you are hosting on cPanel powered hosting, you can setup database and users via the cPanel > MySQL area.
Enter the e-mail and credentials for the administrator account. A greeting letter will be sent to the administrator e-mail account upon successful installation of BoxBilling.
Even though BoxBilling is free it requires license key in order to work. Obtain license key
Finish installation with confirming that all the information is correct.
After installation is complete
Remove 1&1 Internet - Home directory completely
Change billing/bb-config.php file permissions to 644 if necessary
Setup cron job to run every five minutes.
*/5 * * * * php install/path/bb-cron.php
Installation is complete and you can visit admin area at 1&1 Internet - Home
Changing application timezone
By default BoxBilling installs with “America/New_York†timezone. To change this open bb-config.php file and edit line with preferred timezone.
date_default_timezone_set('America/New_York');
All available timezones are listed at PHP: List of Supported Timezones - Manual
Enabling search engine friendly URL’s
When SEO urls are not enabled all BoxBilling urls will have index.php prefix. To enable search engine friendly urls follows these steps:
Rename htaccess.txt (file which comes with installation) to .htaccess
Open bb-config.php file and set BB_SEF_URLS to true
define('BB_SEF_URLS', TRUE);
Note
SEO urls will also turn on for admin area. Old links will stop working.
Debugging and error logging
Enable BoxBilling debug mode in bb-config.php file:
define('BB_DEBUG', TRUE);
This will show errors on your site and provides more debugging information. If you set BB_DEBUG to FALSE it will still log all errors log file. It can be accessed at bb-data/log/php_error.log
nginx host configuration
location ~ bb-admin\.php {
if (!-e $request_filename) {
rewrite ^(.+)$ /bb-admin.php?$1 last;
}
}
location / {
if (!-e $request_filename) {
rewrite ^(.+)$ /index.php?$1 last;
}
}
Directory structure explanation
bb-data
Directory where BoxBilling cache, logs and uploaded data is stored
bb-library
Directory for system files and extensions
bb-locale
Directory for interface translations.
bb-modules
Directory for modules
bb-themes
Directory for client and admin area themes
install
BoxBilling web installer. Can be safely removed after installation
index.php
Main BoxBilling file where all requests are gathered
Supports automated billing, invoicing, product provisioning
Automatically create hosting accounts as soon as the payment is received
Suspend when account becomes overdue, terminate when a specified amount of time passes.
Enable multiple currencies, accept one time and recurring payments
Boxbilling is perfectly created to sell
Shared and reseller hosting accounts
Domains
Software licenses
Downloadable products
Custom recurrent billing products
Helpdesk, knowledge base, news and announcements system.
Intuitive Web 2.0 AJAX powered interface with 100% usability score!
Invoicing
Use BoxBilling just for issuing invoices for your clients without any product setup.
Perfect for companies to issue custom invoices, notify client and collect money.
Define custom invoice lines and select taxes
Every invoice can have custom taxation rule
Track invoice refunds
Allow your clients pay in their currency and track profit in your currency
Automation
Product creation for hosting accounts, domains, licenses, and downloadable products can be done automatically after the successful payment is received or even with no payment received.
Product creation can be also executed after the administrator approval.
Order can be automatically suspended is no payment was received for X days and unsuspended as soon the late payment will be collected.
Client area password can be automatically reset without the by the client itself.
Control panel password can be reset by the client itself without need to logon on to control panel (depends on server manager used).
Payment reminders can be configured to be sent until the order will be terminated or late payment will be collected.
A custom event hook script can be executed on order activation / suspension / reactivation / cancellation so you can setup custom products easily and interrupt workflow as you need
Support system
Integrated helpdesk allows you to communicate with clients easily.
Multiple helpdesk departments are supported so requests can be distributed through along your staff.
Knowledgebase suggestions are automatically displayed for your customers so they can get some question answered even without need to open a ticket.
Predefined replies can be inserted by the click of mouse and supports system, order and client details variable parsing. That saves a lot time for you and allows sending personalized predefined answers.
News & Announcements system allows you to inform your clients about what is going at the moment and notify about upcoming events.
Knowledgebase allows defining the answers for the most frequency asked questions.
Web Hosts Ready
Easy server setup: provide IP, server type, username / password combination and everything else such as account creation will be done automatically.
Server access roles: BoxBilling will work perfectly no matter if you have root access or just a reseller account.
Disk space, bandwidth, additional features and function can be fully customized for each hosting plan.
Full integration and automation is available with BoxBilling extensions, such as cPanel, Plesk, Directadmin and others.
Even if your hosting control panel is not supported you can use BoxBilling to track your orders and clients, just processes account creations / terminations on your server side manually.
Powerful API
BoxBilling modular architecture is backed by REST API. No matter which interface you are using, BoxBilling template file, JavaScript, PHP or any other you always call the same API.
Every BoxBilling module seamlessly extends API, so that all new features created can be accesed from mobile or any other devices.
To avoid API floods requests per time span limits can be easily defined.
Custom Look & Feel
Every theme is open source
Even this site is simply a custom BoxBilling theme
Templates are powered by Twig templating engine
Designers are not limited to system because all templates have access to powerful BoxBilling API
Intuitive and user friendly interfaces is what we what your clients to experience
Every product type has its own order form design for best user experience
Modular system
BoxBilling is designed to be extended
Create your custom extensions
Contribute extensions to community
Multilanguage interface
Client area can be translated in to any language.
Latest version
Version: 2.7.4
Size: 5.89 MB
Released: 2012-07-04
Download Billing Box
System requirements
Environment on which you are going to install BoxBilling should meet these prerequisites:
Linux OS
PHP Version 5.2.4 or later with extensions
PDO MySQL
curl
mbstring
zlib
ftp
gettext
MySQL Version 4.1.* or later
IonCube 3.1 (or greater) loaders
Apache mod_rewrite module enabled, for SEO urls only
It is recommended to install BoxBilling on VPS server with APC cache enabled for best performance and security reasons.
Installation guide¶
To start BoxBilling installation download latest version from download page
After download is complete extract all files on your computer and upload them via FTP to your server.
Using web installer
Web installer is a convenient way to install BoxBilling and it should be used in most cases. This guide is based assuming that you have uploaded all files to subfolder billing
Access installation setup via the browser, by opening 1&1 Internet - Home
You will need to tick “I agree to the license†to continue the installation.
In the next screen a “Pre-Installation check†will recheck if the system (hosting account) does meet the minimum requirements for installation. Most often you will need to login to your account via a file manager (or FTP manager) and set the required permissions (chmod 777) on these files and folders.
In the next step you will need to setup access to the MySQL database. Enter an existing database and user (with all permissions granted). If you have any trouble setting up a MySQL database and user, please consult your hosting provider. For example, if you are hosting on cPanel powered hosting, you can setup database and users via the cPanel > MySQL area.
Enter the e-mail and credentials for the administrator account. A greeting letter will be sent to the administrator e-mail account upon successful installation of BoxBilling.
Even though BoxBilling is free it requires license key in order to work. Obtain license key
Finish installation with confirming that all the information is correct.
After installation is complete
Remove 1&1 Internet - Home directory completely
Change billing/bb-config.php file permissions to 644 if necessary
Setup cron job to run every five minutes.
*/5 * * * * php install/path/bb-cron.php
Installation is complete and you can visit admin area at 1&1 Internet - Home
Changing application timezone
By default BoxBilling installs with “America/New_York†timezone. To change this open bb-config.php file and edit line with preferred timezone.
date_default_timezone_set('America/New_York');
All available timezones are listed at PHP: List of Supported Timezones - Manual
Enabling search engine friendly URL’s
When SEO urls are not enabled all BoxBilling urls will have index.php prefix. To enable search engine friendly urls follows these steps:
Rename htaccess.txt (file which comes with installation) to .htaccess
Open bb-config.php file and set BB_SEF_URLS to true
define('BB_SEF_URLS', TRUE);
Note
SEO urls will also turn on for admin area. Old links will stop working.
Debugging and error logging
Enable BoxBilling debug mode in bb-config.php file:
define('BB_DEBUG', TRUE);
This will show errors on your site and provides more debugging information. If you set BB_DEBUG to FALSE it will still log all errors log file. It can be accessed at bb-data/log/php_error.log
nginx host configuration
location ~ bb-admin\.php {
if (!-e $request_filename) {
rewrite ^(.+)$ /bb-admin.php?$1 last;
}
}
location / {
if (!-e $request_filename) {
rewrite ^(.+)$ /index.php?$1 last;
}
}
Directory structure explanation
bb-data
Directory where BoxBilling cache, logs and uploaded data is stored
bb-library
Directory for system files and extensions
bb-locale
Directory for interface translations.
bb-modules
Directory for modules
bb-themes
Directory for client and admin area themes
install
BoxBilling web installer. Can be safely removed after installation
index.php
Main BoxBilling file where all requests are gathered
Comment