If you already have Signer installed and require instructions on loading an update, please go to https://simcycreative.com/signer-updating-upgrading/.
For new customers, please continue with the following steps.
This video shows how to install signer from step 1-4, for step 5 onwards continue reading the documentation and more videos included.
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 important 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.
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
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) Dropbox API key
Signer provides the ability to import documents from a Dropbox account. This functionality is optional and can be disabled by having an empty Dropbox App key on the System Settings screen.
If you do wish to use this functionality, a Dropbox App Key for your Dropbox account is required.
Please refer to the instructions on how to Create a Dropbox App and set the options as 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 (optional)
To create your own digital signature, use the codes below to create .crt file and .p12 file from your terminal. Password put 1234
openssl req -x509 -nodes -days 36500 -newkey rsa:1024 -keyout tcpdf.crt -out tcpdf.crt;
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 certificate you will need to upload the certificate so it can be downloaded by your users.
The .p12 file should be compressed in to a file called credentials.zip and then uploaded to a folder called “downloads” in your “uploads” folder (i.e. the file should be located at “/uploads/downloads/credentials.zip”).
You also need to ensure the option to “Allow users to download p12 certificate” is enabled on the Settings > System page.
These steps are covered in 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;
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 at https://simcycreative.gitbook.io/signer/
// 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.
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.