Signer Docs

Installation

This video shows how to install signer from step 1-4, for step 5 onwards continue reading the documentation and more videos included.

If you had already installed Signer and want to update go to https://simcycreative.com/signer-updating-upgrading/  . For new customers continue with the instructions below;

Installation is easy and will take less than 5 minutes. lets roll.

1) Copy Files

Unzip the file you downloaded from CodeCanyon, copy the contents in the folder called signer and paste them in your desired directory where you want to install the system.

If you are installing Signer inside a folder for i.e https://example.com/signer or localhost/signer check out this one step then come back. https://simcycreative.com/installing-simcify-web-apps-inside-a-folder/ 

2) Import Database

When you unzipped the file in step 1, there is a folder called database you will find. In there you will find an SQL file, that is the system database. Import it to your PhPMyAdmin or whatever system you use. Watch this video if you are new to importing SQL databases.

3) .htaccess file

This is a very impotant file that you will find in the signer main folder, this file creates the SEO friendly URLs. if you can see it, change your directory setting to show (. files) and if you still can see it you can copy again from your unzipped downloads folder.

4) Edit .env file

On the folder you pasted on your installation folder, you will find a file called .env . This is a very important file that stores system variables. Open the file in a text editor and edit the following lines. The other lines can be edited via the system settings page so don’t worry about them.

APP_URL=https://example.com
DB_HOST=localhost
DB_USERNAME=username
DB_PASSWORD=password
DB_DATABASE=database_name

5) Email SMTP settings

SMTP settings on the settings page are your email settings, this system depends on them to send important system emails, without them your emails wont work. So please don’t forget to update them. Now you are all set! Have fun 🙂

6) Cloud Convert API key

Cloud convert key is required if you intend to upload word (.docx) files, this API will be used in converting .docx files to pdf. To get the API key, Create An Account here, the click this link https://cloudconvert.com/dashboard/api to get your API key

7) Google API key

This is required for importing files from users google drive accounts, follow this instruction on how to create a Google Oauth Client Id and follow this instructionsto create and API key. Once you have created a project, api key and client id, you now need to activate Google drive API, follow this Instructions and enable Google drive API as shown on the image below.

8) Google API key

Dropbox App Key is requred to import files from drpbox.To get started Create a Dropbox App and set the options shown below.

On the next screen under Chooser/Saver domains, enter your domain name and under Redirect URIs enter https://yourdomain.com/dropbox/web-file-browser.php/dropbox-auth-finish

9) Create your digital signature

To create your own digital signature, use the codes below to create .crt file and .p12 file from your terminal. Password put 1234

crt file

openssl req -x509 -nodes -days 3100%00 -newkey rsa:1024 -keyout tcpdf.crt -out tcpdf.crt;

p12 file

openssl pkcs12 -export -in tcpdf.crt -out tcpdf.p12;

To install your self signed certificate or signer sertificate to Adobe Acrobat, please check the video below;

If you create your own self signed certicate you will need to update the certificate downloaded by your users, to do that please watch the video below;

10) Cron job settings

You need to set a cron job that will be running daily to check for late signing requests. This is necessary is you have turned reminders ON. Below is a sample cron job code.

0 0 * * * /usr/local/bin/php -q /home/YOURUSERNAME/public_html/cron.php;

Important files

Below are important PHP, JS, CSS and PHP files for easy customization.

1) CSS files

Signer uses one main CSS file located in the assets folder. You can edit this file to add your custom styling.

// file path
assets > css > style.css

2) Js files

Signer user three main JS files, the first one is app.js; this file contains system wide js functions for manipulating the DOM. The second one is signer.js; This file has functions that only work on the signing page and performs signing & editing functions only. The third one is files.js; this one is used pages that has a file manager; that is dashboard, documents page and templates page.

We have a js framework called simcify.js which has reusable functions like submitting forms, validations and other DOM interactions. You can it’s documentation here https://docs.simcycreative.com/

// Edit this to add global scripts that work
on all pages

assets > js > app.js

// Edit this to add scripts that work
on the signing page

assets > js > signer.js

// Edit this to add scripts that work
on the file manager page

assets > js > files.js

3) PHP files

Signer uses PHP exclusively for server side coding, all view files are under views folder and included files such as sidebar, header, footer & email templates files are under views/includes folder and TCPDF library, controllers and function files are in the src folder.

Signer uses two major PHP libraries

TCPDF – for saving php documents.
PHPMAILER – for sending emails.
PHP SIMPLE ROUTER – for routing

Check composer.json for all PHP libraries used.

Need Support?

If you still need more information about Signer or support please feel free
to get in touch and we will respond as soon as possible.