# Overview

All the documentation needed in order to fully configure, install and use the product.Thank you for purchasing the product and if you haven't yet, check out the demo and the product's page.

## 📢 Important Notice <a href="#item-description__notice" id="item-description__notice"></a>

THIS SCRIPT REQUIRES PROXIES TO BYPASS TIKTOK CAPTCHAS, WE RECOMMEND TO USE [**BRIGHTDATA**](https://bit.ly/brightdata-proxy) SHARED PROXIES, YOU NEED TO TOPUP MINIMUM $5 IN ORDER TO ACTIVATE YOUR ACCOUNT, [**CLICK HERE**](https://bit.ly/brightdata-proxy) TO SEE MORE INFORMATION.

<figure><img src="https://2795438501-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M5GgaQN5V2iBfGWEmQi%2Fuploads%2FCQJJfjXArUCMKGMRg92i%2FBrightData.png?alt=media&amp;token=de906ae4-1472-4066-8d59-f96a3e530872" alt=""><figcaption></figcaption></figure>

## &#x20;💻 Requirements

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

| Requirements      |                                          Recommended |
| ----------------- | ---------------------------------------------------: |
| Hosting           |               Private/Dedicated Server (Recommended) |
| Data Storage      |                                        1GB (Minimum) |
| PHP               |                                               8.0.2+ |
| Extensions        | cURL, OpenSSL, mbstring, PDO, MySQLi, GD, JSON, EXIF |
| allow\_url\_fopen |                                                   On |
| Apache            |                                    with mod\_rewrite |
| MySQL             |                            MySQL 5.7.8 ( or higher ) |

## 💼️ Installation Services

I also offer quality installation services at a low cost.

#### Product Installation ( $15 )

This service is strictly related to the product full installation and does not include fixes or installations if your server is not compatible.

#### Full Server Installation ( $75 )

The full server installation package includes the following: (only available for DigitalOcean servers)

* Creation of a new Droplet on DigitalOcean
* Setting up the domain with 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**

### [🕶Hire Us](mailto:hasnain.khurshid96@gmail.com)


# Installation

Installing the script on your web host should be a quick and easy process. Follow these detailed steps to get the script up and running in just a few minutes.

### 📢 Important Notice <a href="#item-description__notice" id="item-description__notice"></a>

THIS SCRIPT REQUIRES PROXIES TO BYPASS TIKTOK CAPTCHAS, WE RECOMMEND TO USE [**BRIGHTDATA**](https://bit.ly/brightdata-proxy) SHARED PROXIES, YOU NEED TO TOPUP MINIMUM $5 IN ORDER TO ACTIVATE YOUR ACCOUNT, [**CLICK HERE**](https://bit.ly/brightdata-proxy) TO SEE MORE INFORMATION.

<figure><img src="https://2795438501-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M5GgaQN5V2iBfGWEmQi%2Fuploads%2FCQJJfjXArUCMKGMRg92i%2FBrightData.png?alt=media&amp;token=de906ae4-1472-4066-8d59-f96a3e530872" alt=""><figcaption></figcaption></figure>

### Prerequisites

Before you begin the installation process, make sure you have the following items ready:

* Download the script zip file from CodeCanyon
* Obtain the license code for your purchase from CodeCanyon. You will need this during the installation process.
* Create a new database and database user on your web host
* Make note of the database host, name, username, and password. You will need this information during the installation process.

### Customizing Site Assets

To personalize your site and make it your own, you will need to replace the following default assets with your own:

* Site logo: `\themes\Minimal\resources\assets\images\logo.svg`
* Site favicon: `\public\favicon.png`
* Site cover image: `\public\cover.jpg`

### Configuring the Root Directory

1. The script contains a `/public` folder which handles all requests. You will need to extract the script files to your `/public_html/` folder on your web host, and configure the root directory to serve files from the `/public_html/public/` folder.
2. For example, if your domain is `https://yourdomain.com`, it should serve files from the `/public_html/public/` folder.
3. Here is how to configure the root directory in different environments:
   * Apache & Nginx: [Tutorial link](https://docs.rackspace.com/support/how-to/nginx-and-apache-default-paths/)
   * cPanel: [Tutorial link](https://bobcares.com/blog/cpanel-change-root-directory/)
   * Plesk: [Tutorial link](https://docs.plesk.com/en-US/obsidian/administrator-guide/web-hosting/website-directory-structure/defining-a-custom-document-root.77500/)
4. Make sure to also upload the `.htaccess` file located in the `/public/` folder. This is an important step, as failure to do so may result in errors.

#### If you're using Hostinger hPanel, the shared subscription doesn't allow domain root directory configuration, so we need to make some adjustments to make it work. See the tutorial video below

{% embed url="<https://www.youtube.com/watch?v=38UfrFO7XEk>" %}

####

### Installation

1. Set the permissions (CHMOD) of the base folder, subfolders, and files to 755, 775, or 777, depending on your server. This will allow the script to access and modify these files as needed.
2. APP URL is your domain name (eg. <https://domain.com> or <https://tiktok.domain.com>), it's useful when you want to install the script in a sub-domain.
3. Access the product on your website and go to the `/install` path (e.g. `https://yourdomain.com/install`). This will start the installation process. Follow the prompts to complete the installation, including entering your database, license code, and admin account information.
4. Once the installation is finished, you can access the website and log in with your chosen admin account credentials:
   * URL: `https://yourdomain.com/admin/`
   * Email: \[chosen during installation]
   * Password: \[chosen during installation]

**Note:** If you are using version 1.x or 2.x of the script, you will need to clean install with a new database as there is no backward compatibility.

### Final Thoughts

That's it! You should now have the script installed and running on your web host. If you have any issues during the installation process, or if you have any questions, don't hesitate to reach out for assistance.

<br>


# Configuration

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

### 1. Ad code setup (AdSense)

In order to serve AdSense ad code you need to verify the domain first before the ads gets served on your website.

{% hint style="info" %}
This tutorial is for AdSense only but any other Ad Network can be used as well.
{% endhint %}

#### 1. Verify Domain

Add new site on your AdSense account and copy the verification code and paste it in your **head.blade.php** file found in the \themes\Minimal\resources\views\components\ folder, it'll load the script in the \<head> section of the website.

{% code title="Example Code" overflow="wrap" %}

```
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-xxxxxxxxxxxxxxxx"
     crossorigin="anonymous"></script>
```

{% endcode %}

#### 2. Create Ad Units&#x20;

Create 4 different ad units with the following configurations and paste the ad code in below mentioned files.

Ad Configuration;

* Ad Size: Responsive
* Horizontal Ads

Copy the ad unit codes and paste them in the following files located in the **\themes\Minimal\resources\views\components\ad\\** folder.

* hero-section-ad.blade.php
* about-section-ad.blade.php
* usage-section-ad.blade.php
* faq-section-ad.blade.php

{% code title="Ad Unit Example" %}

```
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-xxxxxxxxxxxxxxxx"
     crossorigin="anonymous"></script>
<!-- xh-res-test -->
<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-xxxxxxxxxxxxxxxx"
     data-ad-slot="xxxxxxxxxx"
     data-ad-format="auto"
     data-full-width-responsive="true"></ins>
<script>
     (adsbygoogle = window.adsbygoogle || []).push({});
</script>
```

{% endcode %}

### 2. Cron job setup

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

Create a new cron job with the following command to run once in an hour.

```
0 * * * * /usr/local/bin/php /public_html/artisan schedule:run >> /dev/null 2>&1
```

Make sure to replace the `/usr/local/bin/php` with your own PHP path & `/public_html/` with your own script directory.

### 3. Add Google Analytics Code

In order to use Google Analytics you need to add gtag.js into the \<head> section of your website, you can do so by adding the script code into the **head.blade.php** file located in the **\themes\Minimal\resources\views\components\\** folder.

{% code title="Example Code" %}

```
<!-- Global site tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-UA-XXXXXXXX-X"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'UA-XXXXXXXX-X');
</script>
```

{% endcode %}

### 4. BrightData Proxies Setup

You can easily add BrightData proxies in your script by following the below steps.

**1.** Create an account on [BrightData.io](https://bit.ly/brightdataproxy)

**2.** After successfully activating the account go to the "Zones" Section from the side menu and click on "Add Zone" button.

![Referrence Image](https://2795438501-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M5GgaQN5V2iBfGWEmQi%2F-MMEheR5tPEAsFf50dd1%2F-MMEkc2tUuYPFpGyVp9R%2F1_luminati.io.png?alt=media\&token=9d7f8a73-3d34-42db-8ce7-9448f02c3b46)

**3.** In "Add new Zone" page select the following options and create zone

* **Network types:** Datacenter
* **Price plan:** Pay as you go\* - $0.6/GB
* **Permissions:** 100% Uptime
* **IP Type:** Shared (Pay per usage)

![Referrence Image](https://2795438501-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M5GgaQN5V2iBfGWEmQi%2F-MMEheR5tPEAsFf50dd1%2F-MMEmSizf-NEY2dI0Xi_%2F2_luminati.io.png?alt=media\&token=1c117947-c2e9-4932-9451-f64a2b1e004f)

**4.**  After creating Zone click on the Edit icon and you'll get the following screen, from there you can get your Zone **Username** & **Password**.

![Referrence Image](https://2795438501-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M5GgaQN5V2iBfGWEmQi%2F-MMEma1i50JzFQixoXrH%2F-MMEo8xaKLP53ECfYxYA%2F3_luminati.io.png?alt=media\&token=2ac98e24-8e24-4999-9779-b1949052ebab)

**5.** You've created your zone and got your zone **username** & **password**, now open your TikTok script admin panel and add your BrightData proxies.

**6.** Open script admin panel and navigate to **Configure Proxies** section.

**7.** Click on Add Proxy, a new page will get open.

**8.** Add the newly generated proxy and press Add Proxy button.

* Protocol: HTTP/HTTPS
* Hostname: zproxy.lum-superproxy.io
* Port: 22225
* Has Authentication: True
* Username: {your-zone-username}
* Password: {your-zone-password}

**9.** Voila! You've successfully added your proxy.

### 5. Add New Language/Translation

In new script update, multi-language support is added. You can now create multiple languages for every theme.

Every theme can have it's own translations, in order to add or remove a language follow the below steps.

{% hint style="info" %}
We'll Add Russian language in this tutorial
{% endhint %}

#### 1. Create JSON File

Open **\themes\Minimal\lang\\** folder and duplicate the **en.json** file and rename it with the desired language code (i.e "en" for English, "ru" for Russian). We'll rename it to ru.json.

Open & edit the newly duplicated **ru.json** file and translate the english text into the Russian language using any text editor.

{% code title="Original" %}

```
   "Popular videos": "Popular videos",
    "How to save TikTok video?": "How to save TikTok video?",
    "Download TikTok Video": "Download TikTok Video",
    "Just insert a link": "Just insert a link",
    "Paste": "Paste",
    "Download": "Download",
```

{% endcode %}

{% code title="Translated" %}

```
   "Popular videos": "популярные видео",
    "How to save TikTok video?": "Как сохранить видео из TikTok?",
    "Download TikTok Video": "Скачать видео с ТикТок",
    "Just insert a link": "Просто вставьте ссылку",
    "Paste": "Вставить",
    "Download": "Скачать",
```

{% endcode %}

#### 2. Enable Language

Open your respective theme folder **\themes\Minimal\\** and open **theme.json** file.

Add new line in the locales section, and define your language and it's name.

{% code title="Before" %}

```
{
    "name": "Minimal Theme",
    "description": "Minimal theme for TT Downloader",
    "author": "CodeSpikeX",
    "preview": "screenshot.png",
    "version": "1.0",
    "id": "Minimal",
    "locales": {
        "en": "English",
        "ar": "Arabic",
        "id": "Bahasa Indonesia",
        "de": "Deutsch",
        "es": "Español",
        "tr": "Türkçe",
        "fr": "Français"
    },
    "rtl_support": [
        "ar"
    ]
}
```

{% endcode %}

{% code title="After" %}

```
{
    "name": "Minimal Theme",
    "description": "Minimal theme for TT Downloader",
    "author": "CodeSpikeX",
    "preview": "screenshot.png",
    "version": "1.0",
    "id": "Minimal",
    "locales": {
        "en": "English",
        "ar": "Arabic",
        "id": "Bahasa Indonesia",
        "de": "Deutsch",
        "es": "Español",
        "tr": "Türkçe",
        "fr": "Français", //DON'T FORGET THIS COMMA
        "ru": "Russian"  // NO COMMA AT THE END
    },
    "rtl_support": [
        "ar"
    ]
}
```

{% endcode %}

#### 3. RTL Support

If the language is RTL you need to specify it as well in the **theme.json** file located in the **\themes\Minimal\\** folder.

{% code title="Example" %}

```
"rtl_support": [
        "ar", //DON'T FORGET THIS COMMA
        "ru" // NO COMMA AT THE END
    ]
```

{% endcode %}


# Hosting

We always recommend [**DigitalOcean** ](https://m.do.co/c/54bcd335321f)because of their flexibility from every point of view.

We've been using this webhost for over 2+ years and we never needed to contact their support team.

If you use our referral code, you will get **$50 credit on DigitalOcean**.

### [💰 Claim $50 on DigitalOcean](https://m.do.co/c/54bcd335321f)


# About

I build awesome projects ready to use :) Here's where you can find me:

Support is **only** done through Codecanyon's [email form](https://codecanyon.net/user/codespikex) or **comments** section.

* 💻 [**See other projects**](https://codecanyon.net/user/codespikex)
* 🔥 [**CodeSpikeX.com**](https://codespikex.com)