Documentation

66Analytics by AltumCode

Overview

In this page you can find the needed documentation for you to fully install and configure the product.

The product installation procedure is straight forward and does not require any special / out of the ordinary task. Minimum knowledge on how to work with a database and managing files on a server is required.

Requirements

Please make sure your server meets the following requirements before attempting to install or purchase the product.

PHP PHP 7.4+
Extensions cURL, OpenSSL, mbstring, MySQLi
MySQL MySQL 5.7.3+
Apache with mod_rewrite

Installation Services

I also offer quality installation services at a low cost if you do not want to bother with the installation process.

Product Installation - $25

The product installation package includes the following (you must own a s:

  • Uploading the product files on your server (requires a fully configured and ready to go server).
  • Creating and configuring the database that is going to be used.
  • Full installation of the product.

Full Server Installation - $49

The full server installation package includes the following:

  • Setting up a new server on one of those platforms: Cloudways, Vultr, DigitalOcean
  • Setting up the domain for the server
  • Free SSL Certificate Installation (Let's Encrypt)
  • Installation of Apache, MySQL with MySQLi, PHP
  • Installation and configuration of PHP's necessary modules / extensions
  • Full installation of the product
Get in touch

Installation

This installation process should take no more than 10 minutes if followed and done correctly.

Watch a video tutorial on how you can install the product a shared web host with cPanel.

1. Prepare the database

  1. Create a new Database User for the upcoming new database (optional)
  2. Create a new Database
  3. Prepare the Database Host, Name, Username and Password for the upcoming steps.

2. Upload the product

Upload the content of the product/ folder on your webhost.

The product can be uploaded either on a subdomain, domain or subfolder, depending on your needs.

3. Prepare the product files

You need to set the permissions (CHMOD) of the following files / folders to either 755, 775, or 777 which will depend on your actual server.

  • /uploads/favicon/
  • /uploads/logo/
  • /uploads/cache/
  • /uploads/opengraph/
  • /uploads/store/
  • /uploads/offline_payment_proofs/
  • /config.php

4. Start the installation process

  1. Access the product on your website and access the /install path. (ex: https://yourdomain.com/install)
  2. Follow the steps in the installation process
  3. You can now access the website and login with your admin account

5. Cron job setup

The cron job must be set up as it is responsible for handling background tasks.

  1. Make sure to login and go to the Admin Panel -> Website Settings -> Cron tab
  2. Create a new cron job with each cron job commands that you see in there.

Update

This part of the documentation is for the time when you want to update your current installation to newer releases.

Watch a video tutorial on how you can update the product a shared web host with cPanel.

1. Backup

Before even starting with the updating process, you must backup to make sure that if something goes wrong, you can always restore to the previous version.

  1. Backup your database
  2. Backup your files

2. Files update

Make sure to download the latest version of the product, unzip the archive and go inside the product folder.

To update the files, you just simply have to replace all the folders and files by dragging and dropping the folders and files from the new version, over the latest version.

Do not replace nor upload the following files/folders:

  1. /config.php
  2. /install/

3. Database update

  1. Go to your website and access the /update path, just like the following format: https://domain.com/update.
  2. Follow all the steps inside of the updating process
  3. After you are finished, make sure to delete the update folder as you do not need it anymore.

Extra Configuration

Here are the integrations that you can configure on the product after installation.

Nginx Servers

The product was designed to work by default for Apache servers. This is an extra thing that I provide for NGINX users although support is NOT guaranteed for NGINX servers.

The rewrite rule for NGINX that you need to add so that the urls work is the following:

if (!-e $request_filename){ rewrite ^\/(.+)$ /index.php?altum=$1 last; }

This command should be added in your domain.conf nginx file in the location / { ... } field.

Facebook Login

The Facebook Login integration gives your users the ability to skip normal registration and login directly with their Facebook account.

Watch a video tutorial on how you can setup Facebook Login.

  1. Go to Facebook Developers page.
  2. Make sure to login to your Facebook account.
  3. Click on the My Apps menu dropdown and click on Create app.
  4. Add your details to the form and click submit the form to create the new app.
  5. Go to Settings from the sidebar menu and click on Basic.
  6. Fill out your Facebook app details in there.
  7. From the sidebar, under Facebook Login click on Quickstart link.
  8. Click on the Web platform and add your website URL. Skip the next steps.
  9. From the sidebar, under Facebook Login click on Settings link.
  10. In the Valid OAuth redirect URIs field, add your website's URL in this format: https://yourdomain.com/login/facebook (replace yourdomain.com with your own domain name).
  11. Save the changes.
  12. Go to App Profile page and copy the App ID and App Secret.
  13. Go to your website installation Admin Panel -> Website Settings -> Facebook Login Tab and fill in the copied keys.
  14. Make sure to Enable Facebook Login and Submit the new settings.
  15. Future configuration & review of the created Facebook app is fully up to you from now on.

Google Login

The Google Login integration gives your users the ability to skip normal registration and login directly with their Google account.

Watch a video tutorial on how you can setup Google Login.

  1. Go to Google Developers Console page.
  2. Make sure to login to your Google account.
  3. Create a new project and select it.
  4. Go to OAuth consent screen menu item on the left.
  5. Select the User Type as External and click Create.
  6. Fill out your app details in there, save and continue.
  7. Make sure to add the userinfo.email & userinfo.profile scopes, save and continue.
  8. Finish the last remaining steps.
  9. Go to Credentials menu item on the left.
  10. Create new OAuth client ID credentials.
  11. Select the Web application type.
  12. In the Authorized redirect URIs field, add your website's URL in this format: https://yourdomain.com/login/google (replace yourdomain.com with your own domain name).
  13. Create the credentials.
  14. Copy the Client ID and Client Secret.
  15. Go to your website installation Admin Panel -> Website Settings -> Google Login Tab and fill in the copied keys.
  16. Make sure to Enable Google Login and Submit the new settings.
  17. Future configuration & review of the created Google app is fully up to you from now on.

Twitter Login

The Twitter Login integration gives your users the ability to skip normal registration and login directly with their Twitter account.

  1. Go to Twitter Developer Portal page.
  2. Make sure to login to your Twitter account and submit your application for being accepted into the program.
  3. Go to Projects & Apps -> Overview menu item on the left.
  4. Click on the Create App button.
  5. Fill out your app details in there, save and continue.
  6. Make sure to add the Authentication settings of the app by enabling 3-legged Oauth & enabling the Request email addresses from users.
  7. In the Callback URLs field, add your website's URL in this format: https://yourdomain.com/login/twitter (replace yourdomain.com with your own domain name).
  8. Fill out the other details that are required.
  9. Go to Keys and tokens of the new app that you created.
  10. Get your API Key and API Secret.
  11. Go to your website installation Admin Panel -> Website Settings -> Twitter Login Tab and fill in the copied keys.
  12. Make sure to Enable Twitter Login and Submit the new settings.

PayPal

The PayPal integration gives your users the ability to pay via PayPal on your website.

  1. Go to PayPal Developer Console and Login to your account after clicking the Log into Dashboard button
  2. Go to REST API apps section and click the Create App button.
  3. Add your own details for the new app and create it.
  4. Switch to Live by clicking the button near your new App's Name.
  5. Copy the Client ID and Secret
  6. Go to your product installation Admin Panel -> Website Settings -> Paypal Tab and enter the Client ID and Secret keys.
  7. Make sure to also switch the Mode to Live and Submit the new settings.
  8. Go to the newly created App in the Paypal Developer Console and click on the Add Webhook button.
  9. In the Webhook Url field, add your website's URL in this format: https://yourdomain.com/webhook-paypal (replace yourdomain.com with your own domain name).
  10. In the Event types field, check the Payment sale completed, Checkout order approved events and submit the Webhook.

Stripe

The PayPal integration gives your users the ability to pay via Stripe on your website.

  1. Go to Stripe Dashboard and Login to your account.
  2. Go to Stripe API Keys page.
  3. Make sure your API keys are set to Live Mode so that you can accept real payments.
  4. Copy the Publishable key and Secret key.
  5. Go to your product installation Admin Panel -> Website Settings -> Stripe Tab and enter the Publishable key and Secret Key.
  6. From the sidebar, under Developers click on Webhooks link.
  7. Click on the Add endpoint button
  8. In the Endpoint URL field, add your website's URL in this format: https://yourdomain.com/webhook-stripe (replace yourdomain.com with your own domain name).
  9. In the Events to send field, select the checkout.session.completed, invoice.paid, invoice.upcoming and click the Add endpoint button.
  10. Copy the Signing secret key and paste it in the product's Webhook Secret field in the admin panel.

Offline payments

The offline payments integration gives your users the ability to pay offline (bank transfer, for example), give you the proof of payment and receive what the customer paid for when the payment is approved.

  1. As an admin you can enable the offline payments system from the Admin Panel -> Website Settings -> Offline payment tab.
  2. In the Instructions field you can write details for the user on where to send an offline payment.
  3. The customer will have the ability to choose the offline payment method when checking out.
  4. The customer will see the Instructions for the payment and also be required to upload a proof of payment.
  5. When the customer checks out, the admin will need to go in the Admin Panel -> Payments page and review the proof of purchase and then, approve it.
  6. After the approval, the customer will get the plan that was chosen
  7. If the proof of payment is not correct and the payment is fake, simply delete the payment from the list.

Coinbase

The Coinbase integration gives your users the ability to pay with crypto via the Coinbase payment gateway.

  1. Go to Coinbase Dashboard and Login to your account.
  2. Go to Coinbase Settings page.
  3. Scroll down to the API Keys section and copy the API key.
  4. Go to your product installation Admin Panel -> Website Settings -> Coinbase Tab and enter the API Key.
  5. Scroll down to the Webhook subscriptions section, click on the Add an endpoint button.
  6. In the field, add your website's URL in this format: https://yourdomain.com/webhook-coinbase (replace yourdomain.com with your own domain name) and save it.
  7. Copy the Shared secret webhook secret key and paste it in the Webhook Secret field in the admin panel.

PayU

The PayU integration gives your users the ability to pay with via the PayU payment gateway for one time purchases.

  1. Go to PayU and Login to your account.
  2. Create a new shop, fill in all the details.
  3. Go to your product installation Admin Panel -> Website Settings -> PayU Tab and enter the given API Keys.

Paystack

The Paystack integration gives your users the ability to pay with via the Paystack payment gateway for one time & recurring purchases.

  1. Go to Paystack and Login to your account.
  2. Go to the Settings page -> API Keys & Webhooks tab on Paystack.
  3. Go to your product installation Admin Panel -> Website Settings -> Paystack Tab and enter the given API Keys.
  4. Add your website's URL in this format: https://yourdomain.com/webhook-paystack (replace yourdomain.com with your own domain name) in the Webhook URL field & save the changes.

Razorpay

The Razorpay integration gives your users the ability to pay with via the Razorpay payment gateway for one time & recurring purchases.

  1. Go to Razorpay and Login to your account.
  2. Go to the Settings page -> API Keys tab on Razorpay & generate your API keys.
  3. Go to your product installation Admin Panel -> Website Settings -> Razorpay Tab and enter the given API Keys.
  4. Go to the Settings page on Razorpay & generate your API keys.
  5. Go to the Settings page -> Webhooks tab on Razorpay & Add a new Webhook.
  6. Add your website's URL in this format: https://yourdomain.com/webhook-razorpay (replace yourdomain.com with your own domain name).
  7. Add a new Secret (like a password) & check the subscription.charged and payment_link.paid & save the webhook.
  8. Go to your product installation Admin Panel -> Website Settings -> Razorpay Tab and enter the set webhook secret.

Mollie

The Mollie integration gives your users the ability to pay with via the Mollie payment gateway for one time & recurring purchases.

  1. Go to Mollie and Login to your account.
  2. Go to the Developers -> API Keys page on Mollie get your API key.
  3. Go to your product installation Admin Panel -> Website Settings -> Mollie Tab and enter the given API Key.
  4. Make sure to activate your allowed payment methods via your Mollie account.

Yookassa

The Yookassa integration gives your users the ability to pay with via the Yookassa payment gateway for one time purchases.

  1. Go to Yookassa and Login to your account.
  2. Go to the Developers -> API Keys page on Mollie get your API key.
  3. Go to your product installation Admin Panel -> Website Settings -> Yookassa Tab and enter your Yookassa required API keys.
  4. Go to Yokassa Integration - HTTP Notifications and add a new Webhook.
  5. Add your website's URL in this format: https://yourdomain.com/webhook-yookassa (replace yourdomain.com with your own domain name).

Taxes & Billing

The taxes system is helpful when you want to add taxes that the user gets included or needs to pay extra. Taxes need to be created & configured as per your specifications and attached to any created plan.

  1. As an admin you can enable the Taxes & Billing system from the Admin Panel -> Website Settings -> Payment tab.
  2. The Taxes & Billing system will give all your users the ability to enter their billing details before checking out and will give you the ability to create and attach taxes to paid plans.
  3. Go to the Admin Panel -> Taxes page.
  4. Start by creating a new Tax by clicking on the Create Tax button.
  5. Once you have one tax ready, you can go to the Admin Panel -> Plans page, select a paid plan and then you'd be able to activate a certain tax to be applied.

Google Recaptcha

  1. Go to your Admin Panel -> Website settings -> Captcha page.
  2. Set the captcha type to Google ReCaptcha v2 checkbox.
  3. Go to Recaptcha Admin Panel and Login to your Google account.
  4. Make sure to select the reCAPTCHA v2 type
  5. Fill in the other needed details from the form.
  6. Copy the Site Key and Secret Key and paste them in the Admin Panel.
  7. Save your new settings in the admin panel.

hCaptcha

  1. Go to your Admin Panel -> Website settings -> Captcha page.
  2. Set the captcha type to hCaptcha.
  3. Go to hCaptcha and create/login to your account.
  4. Go to Add New Site and fill in the required details.
  5. After submitting your new site, go to the sites page, select the newly added site and click on Settings.
  6. Copy the Site key and paste it in the Admin Panel.
  7. Go to hCaptcha settings.
  8. Copy the Secret key and paste it in the Admin Panel.
  9. Save your new settings in the admin panel.

Hosting & domains

VPS Hosting

(intermediate, advanced)

If you are just starting out to work with VPS servers & do not want to complicate yourself with server management, manually installing & configuring the server, then I would highly suggest Cloudways.

Get Cloudways hosting

If you do not need the managed cloud hosting solution and you are confortable with managing and configuring your own VPS, I would suggest going for Vultr.

Get $100 on Vultr

Shared hosting

(beginner)

When you are starting out and you do not have that much knowledge, I would highly suggest getting a shared webhosting plan.

Why? Because you get a lot of value for the money, such as: a free domain (in some cases), cpanel, support, documentation, custom domain email...etc.

Namecheap web hosting

Domains

Since I have found NameCheap almost 2 years ago, I have personally transferred all my domains from Godaddy to Namecheap as they offer better deals, prices for domains and a much more intuitive and simpler user interface.

Namecheap domains

FAQ

Here are the most popular questions and their answers.

  • How can I update text on the website?
    Any from the website can be changed from the app/languages/english.json file for the frontend part. The admin panel translations are found in the app/languages/admin/enlish.json file.
  • How can I create my own language?
    Duplicate the app/languages/english.json file, rename the duplicated file to your actual language name and start editing the newly created file. The same process needs to happen for the admin panel translations, app/languages/admin/enlish.json.
  • When I click on any link it returns 404 Not Found, why?
    That means that you either didn't add the .htaccess file or that your webhost doesn't have mod_rewrite enabled on the apache server.
  • Is there any Sitemap?
    Yes, you can access the sitemap by accessing the /sitemap path on the website.
  • Emails are not sending / I have errors with my SMTP.
    All errors related to the email sending system are caused by either: Incorrect SMTP credentials, not properly working SMTP server, or web host blocking the actual SMTP connection. For any of these issues, contact your SMTP or web host provider.
  • How to customize the index landing page?

    This can be done in multiple ways. You can either edit the actual content by editing the themes/altum/views/index/index.php file, editing the language file for text changes, or the themes/altum/assets/images/ folder for changing any images.

    The second way would be to have a fully custom landing page, and redirecting (disabling) the default landing page, by editing & pasting the new landing page URL in the Custom Index URL field in the Admin panel -> Website settings -> Custom Index URL field.

  • How to customize the colors (CSS) of the site?

    This can be done in multiple ways, depending on your actual CSS/SCSS knowledge.

    You can write your own custom css, that overwrites the already existing rules, and paste that in the Admin panel -> Website settings -> Custom CSS field.

    You can manually replace the colors via the bootstrap CSS files in the themes/altum/assets/css/ folder.

    You can also fully modify the theme, by editing the bootstrap SCSS files in the themes/altum/assets/css/ folder, recompile them back to CSS, and then overwrite the original CSS bootstrap files (advanced).

  • When are the session replays and heatmaps coming out of beta?
    Session replays and heatmaps are a custom integration from an open-source project which is still getting updates and under development. This open source project helps us with the technology behind capturing sessions and replaying them.

About

I build High quality, ready to use & affordable software. Here's where you can find me:

Support is only done through email.