m'Manager | Invoices Management System - Documentation v2.0

m'Manager | Invoices Management System

Created: 2017/04/30
By: Eric Claver AKAFFOU

I would like to thank you for purchasing m’Manager. If you have any questions that are beyond the scope of this help file, please feel free to email via my user page contact form here. Thanks so much!

Table of Contents

  1. About
  2. Server Requirements
  3. Installation
  4. Update
  5. Cron Job
  6. Troubleshoot
  7. Getting Started
  8. Changelog and New Features
  9. Acknowledgement
  10. Translations

A) About - top

m’Manager is a small but full featured piece of software designed for freelancers and based on CodeIgniter 3. It will help you manage easily your business, create and send automatically your invoices and estimates, keep track of your turnover, tax and items sale performances. Many cool features are coming soon... So welcome on board ! You will enjoy it !

B) Server Requirements - top

m’Manager is easy to run and requires a webserver or webhost with the following specifications:

C) Installation - top

If your are comfortable with installing web applications, m’Manager should take only 5 minutes or less. Here is a cPanel installation example.

  1. Create a MySQL Database

    1. Log into cPanel.
    2. Under Databases, click MySQL Databases.
    3. In the New Database field, type a name for the database.
    4. Click Create Database.
    5. Click Go Back.
      • The new database will appear in the Current Databases table.
  2. Create a Database User

  3. After creating the database, you will need to create a user and assign privileges.

    1. Log into cPanel.
    2. Under Databases, click MySQL Databases.
    3. Click Jump to MySQL Users in the top-right corner of the page.
    4. Under Add New User, enter a username.

    5. Enter a password in the Password field.
      • For help generating a strong password, click the Generate Password button.
    6. Retype the password in the Password (Again) field.
    7. Click Create User.
  4. Define a User's Privileges

  5. Privileges determine how a user is able to interact with the database. For example, privileges will dictate whether or not the user can add and delete information.

    1. Log into cPanel.
    2. Under Databases, click MySQL Databases.
    3. Under Add User to Database, select a user from the User drop-down menu.
    4. From the Database drop-down menu, select the database to which you wish to allow the user access.
    5. Click Add.
    6. From the MySQL Account Maintenance screen, select ALL PRIVILEGES.

    7. Click Make Changes.
  6. Upload zip file to the server

    You can install m’Manager where you want, in the root folder, any sub folder or a subdomain.

    IMPORTANT: If you install m'Manager in a subdomain (ie. subdomain.domain.com), you need to make sure the domain .htacess has these two lines:
    RewriteEngine on
    RewriteBase /

    If not, make the changes needed.

    Connect to your web server using any FTP program (ie. FileZilla) and upload the mmanager_full_install_1.x folder from the .zip file you have downloaded from Codecanyon.

    If you use a web-host interface such as cPanel, upload and extract the zip file.

    Rename the folder to whatever you want (ie. mmanager). Your m’Manager application will then be accessible at http://your-domain.com/mmanager

    Now point your web-brower to http://your-domain.com/folder_name/install and fill the form with database name, username and password. Hit Install and you are done !

  7. For security reason, go back to your webserver and delete the install folder.
  8. Login with the default admin email admin@mmanager.com and the default password 123456789

D) Update - top

Follow these steps to update m’Manager

Before you start, make a backup of your database and any customized file. There will be no support if you missed to make a backup and lost any data.

  1. Updates are now automatic, inside the app. You can use the one'click feature. But I will provide update folder if you need manual update. If you need to edit the default theme, use the custom folder located in themes/darkblue/custom. Anyway, make a backup of your database and any customized file to prevent data loss.
  2. m’Manager uses MVC structure. This makes update simple. If you use a control panel such as cPanel, upload and extract the update zip file you downloaded from Codecanyon to the root directory of your m'Manager installation.

  3. Overwrite all the files
  4. Copy all the folders inside the update folder to corresponding folders in your installation. If you use cPanel, just remove the /update on the path and hit copy files That's it !

  5. Login to your m’Manager installation and check if everything is working.
  6. Beacause, m’Manager uses cookies, it may be useful to clear the browser after update.

E) Cron Job - top

m’Manager uses cron jobs to update invoices, quotes status, send recurrent invoices. You need this feature to automate these tasks.

Log into your new m’Manager installation with the default credentials and navigate to the Invoice & Quote link.

We have tried to guess your server configuration to generate a ready to use cron command. Paste the command which should look like this one wget -qO- http://onericcomputing.com/mmanager/cron >/dev/null 2>&1 in your cron tab and set it to run every 5 minutes or as frequently as your web hosting provider allows.

If the command above does not work in a shared hosting environment, please contact your hosting provider.

For more help setting a cron job, follow this link

If you can not set a Cron Job or your hosting provider does not allow cron job on the server, m'Manager will run a built-in alternative cron when the system starts. Go to setting and check Enable Alternative Cron option. Please note that automatic reminders and invoices will go ONLY when you log in. It can also be enabled in conjonction with cron job to execute immediatly tasks.

F) Troubleshoot - top

  • I get 403 Error
  • If you get Error 403, please check files and folders permissions. Open the index.php and set the environment from production to development. You will get more descriptive error messages. Please note also that the uploads folder must have 0777 permission.

  • I get 500 Error

    Here is a comment posted by Askinsavascisi whose hosting provides a specific temp folder for cache. You may need to contact your service provider.
    Good support, In the beginning (first installation), i had wierd multiple errors. it seemed that i needed to make some edit in file -> /application/config/config.php $config['sess_save_path'] = NULL; to temp folder of your shared hosting $config['sess_save_path'] = "PATH_OF_YOUR_HOSTING_TEMPFOLDER";

    You can try to get this default temp folder. Create a file path.php in the root folder and paste this code:

    			<?php echo sys_get_temp_dir(); ?>

    Point your folder to http://your-domain.com/path.php. You should get the temp path. It looks like /tmp

    G) Getting Started - top

    If m’Manager was installed into the root of your web server, login at http://www.your-domain.com
    If it was installed into its own subdirectory of your web server, login at http://www.your-domain.com/the-subdirectory

    1. Login with default credentials
    2. You have successfuly installed m'Manager. Login with the default admin email and password.

    3. Edit Company and Invoice/Quote Settings
    4. Company name is used as email sender. Click on each link and edit settings to feet your needs.

    5. Add Items and Services
    6. Because m'Manager tracks turnover and items performances, you are required to add items and services before quoting and invoicing

    H) Changelog and New Features - top

    You can find a list of all changes for each release in this section:

    This update is highly recommended.

  • Version 1.4 (10-06-2017)
    1. Bugs Fix
    2. This update is highly recommended.

  • Version 1.3 (30-05-2017)
    1. New Features
    2. Changes
    3. Improvements
    4. This update is highly recommended.

  • Version 1.2 (18-05-2017)
    1. Changes
    2. Bug Fixes
    3. This update is highly recommended.

  • Version 1.1 (09-05-2017)
    1. New Features
    2. Changes
  • Version 1.0 (30-04-2017)

  • I) Acknowledgement - top

    Once again, thank you so much for purchasing m'Manager. As I said at the beginning, I'd be glad to help you if you have any questions relating to this Web App. I'll do my best to assist. If you have a more general question relating to this item on Codecanyon, do not hesitate to visit the forums and ask your question in the "Item Discussion" section.

    J) Translation - top

    m'Manager would like to speak all the languages all over the world. The translation file is well structured and easy to work on. If you want to improve your language file or add a new one, we will be happy to hear from you. Please visit our Google Drive folder to suggest better translation Languages

    Eric Claver AKAFFOU

    Go To Table of Contents