# Introduction Last updated: 2023-10-01

Thank you so much for your interest on our product. TCG AGENCY is a feature-rich web application developed using Python Django. It's designed to empower users to create and manage stunning websites with ease. From the frontend website's captivating design to the powerful backend admin dashboard, TCG AGENCY offers a wide array of tools and functionalities to cater to various web development and marketing needs.

## IMPORTANT WARNING: Python & Django Knowledge is an absolute prerequisite

Before proceeding, please be aware of the following:

- This system is built on the Django framework, which utilizes the Python programming language.
- Basic understanding of Python is crucial for successful installation, customization, and troubleshooting.
- Customization and advanced configuration may necessitate Python programming skills.
- If you lack familiarity with Python, consider consulting a Python developer or learning resources.
- Insufficient Python knowledge may hinder implementation and use of TCG AGENCY.

By heeding this warning and having a solid Python foundation, you'll ensure a smoother experience with TCG AGENCY.

Note: After installing the application the website will be show blank. This is not a defect. You have to login to the admin dashboard and add the contents. You will get details instructions that how to install it and login to the dashboard bellow.

## Quick Overview

This quick start guide provides an overview of the key steps included in this documentation.

### 1. Installation

- Ensure Python is installed on your system.
- Download the TCG AGENCY package from the provided source.
- Extract the package and follow the installation instructions below.

### 2. Frontend Website:

- Beautiful Design
- Essential Pages
- Responsive
- Rich Elements

### 3. Admin Dashboard:

- Sleek Design
- Light & Dark Mode
- Authentication
- Content Management

### 4. Marketing Tools:

- Email Marketing
- SMS Marketing
- Subscriber Management

## Conclusion

TCG AGENCY combines a stunning frontend with a powerful admin dashboard to provide a comprehensive solution for creative agencies, developers, and businesses. With its user-friendly features, customization options, and marketing tools, it's your go-to platform for creating, managing, and promoting your online presence.

If you have any questions that are beyond the scope of this help file, Please feel free to email via Item Support Page.

## Features Overview Of TCG AGENCY

TCG AGENCY - Django Creative Agency With Custom Dashboard offers a stunning frontend with a powerful admin dashboard to provide a comprehensive solution for creative agencies, developers, and businesses. With its user-friendly features, customization options, and marketing tools, it's your go-to platform for creating, managing, and promoting your online presence.

### Key Features

#### 1. Frontend Website Features:

- Beautiful Design: TCG AGENCY boasts a captivating and user-friendly website design to make a lasting impression on your visitors.
- Essential Pages: The frontend includes vital pages like Home, About Us, Services, Projects, Pricing, Blogs, and Contact Us for a complete online presence.
- Responsive Design: Your website will look and perform flawlessly on all devices, ensuring a seamless user experience.
- Rich Elements: Incorporate essential elements such as Headers, Footers, Sliders, Testimonials, detailed Service and Project page, Terms & conditions page, Privacy policy pages to engage your audience effectively.
- Dynamic Sitemap: TCG AGENCY generates a dynamic sitemap, enhancing SEO and helping search engines discover your content.
- Custom Error Pages: Customize your 404 and 500 error pages to provide a user-friendly experience even when things go wrong.
- Engaging Animations: Add eye-catching animations to captivate your audience and enhance the overall user experience.

#### 2. Custom Admin Dashboard Features:

- Sleek Dashboard: The admin dashboard offers a sleek and responsive design, making it easy to manage your website.
- Light Mode and Dark Mode: Choose between light and dark modes for a comfortable working environment.
- Authentication: Robust authentication and password management features keep your website secure.
- Content Management: Easily manage website content, including pages, blogs, projects, and services, with an intuitive interface.
- Page Creation:Create custom page to add more information in your system. It will help you to create page with title and content.
- Element Management: Effortlessly handle website elements like Sliders, Fun Facts, Clients, and Team Members to keep your content fresh and engaging.
- User Management: Define user roles (Admin and Editor), granting access based on responsibilities.
- Form Management: Handle form submissions, including Subscription and Contact forms, with ease.
- Menu Customization: Customize menus and submenus to create a tailored navigation experience.
- Settings Customization: Fine-tune your website's settings, including General, Header/Footer, and SEO settings.
- SEO Tools: Improve your website's visibility with built-in SEO tools, including meta tags, descriptions, and keywords.
- Marketing Tools: Utilize TCG AGENCY's email & sms marketing tools for bulk email and sms campaigns, subscriber management, and email & number formatting.

#### 3. Marketing Tools:

- Email & SMS marketing tools for bulk email & sms campaigns.
- Email & Number formatting tool for easy email address & number management.

TCG AGENCY has many more features we will explore them bellow step by step.

# Installation

In this section we will learn that how to install TCG AGENCY in different platforms

# Local Server/Machine

### Common Steps (for all OS):

1. Download and Unzip: Download "TCG AGENCY" from Codecanyone and unzip it to your desired directory.
2. Install Python: If you haven’t installed Python yet, download and install it from python.org.
3. Install Virtual Environment: Install virtual env by this commands
   - Windows:

         pip install virtualenv

   - macOS and Linux:

         sudo apt install python3-virtualenv

4. Virtual Environment: Navigate to the project directory and set up a virtual environment:

   -     virtualenv venv

5. Activate Virtual Environment:
   - Windows:

         venv\Scripts\activate

   - macOS and Linux:

         source venv/bin/activate

6. Install Dependencies: Install required packages using the provided requirements file (typically `requirements.txt`):

       pip install -r requirements_local.txt

7. Now go to the `~/.env` file & make this configurations

- Make the DEBUG=True
- Set the TIME_ZONE
- Make the MYSQL_DB=False (Not applicable if you want to use MySQL in local server which is not recommended. Than make it True and set the DB_NAME, DB_USER, DB_PASSWORD)
- Make the WHITENOISE_CONFIG=False
- Make the MYSQL_DB=False

       # Core
    DEBUG=True
    ALLOWED_HOSTS=*
    TIME_ZONE=Asia/Dhaka
    DEMO_MODE=False

    # Make the MYSQL_DB=True if you want to use MySQL Database
    MYSQL_DB=False

    # Make the WHITENOISE_CONFIG=True for live server
    WHITENOISE_CONFIG=False

    # MySQL Setup
    DB_NAME=database_name
    DB_USER=database_username
    DB_PASSWORD=database_user_password
    DB_HOST=localhost
    DB_PORT=3306

    # Email Credentials
    EMAIL_HOST=smtp.gmail.com
    EMAIL_PORT=587
    EMAIL_USE_TLS=True
    EMAIL_HOST_USER=host_username
    EMAIL_HOST_PASSWORD=host_password

    # Template Setup
    TEMPLATES_DIRS=templates

    # Static Media Setup Path
    MEDIA_ROOT=media

- Migrations: Run the following command to apply migrations:
  - Windows:

        py manage.py makemigrations

  - macOS and Linux:

        python3 manage.py makemigrations

- Migrate: Run the following command to apply migrate:
  - Windows:

        py manage.py migrate

  - macOS and Linux:

        python3 manage.py migrate

- Create Super User: Run the following command to create superuser:
  - Windows:

        py manage.py createsuperuser

  - macOS and Linux:

        python3 manage.py createsuperuser

  Now create a account by giving username, email and password

- Start the Local Server: Run the following command to start the Django development server:
  - Windows:

        py manage.py runserver

  - macOS and Linux:

        python3 manage.py runserver

### OS-Specific Instructions:

1. Windows:
   - Installing Python: Download the installer from python.org. Ensure you check the box that says "Add Python to PATH" during installation.
   - MySQL: Download the MySQL installer for Windows from the official site. Follow the installation steps.
   - You can use XAMPP for windows. Download
   - Read this documentation of XAMPP if you don't know how to use it. XAMPP provide MySQL with phpMyAdmin.
2. macOS:
   - Installing Python:
     - It's recommended to use Homebrew for package management on macOS

           /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

           brew install python

     - or download python from python.org
   - MySQL: Install using Homebrew with the commands

         brew install mysql

     and start using

         brew services start mysql

   - or you can use XAMPP for macOS. Downloads
   - Read this documentation of XAMPP if you don't know how to use it. XAMPP provide MySQL with phpMyAdmin.
3. Linux (Ubuntu/Debian):
   - Installing Python:

         sudo apt update

     and then

         sudo apt install python3 python3-venv python3-pip

   - or download python from python.org
   - MySQL: Use the commands

         sudo apt update

         sudo apt install mysql-server

     and then

         sudo mysql_secure_installation

   - or you can use XAMPP for Linux. Download
   - Read this documentation of XAMPP if you don't know how to use it. XAMPP provide MySQL with phpMyAdmin.

## Live Server ( cPanel/Cloud Hosting )

#### Warning: Python & Django Knowledge is prerequisite.

### Step 1: Create the MySQL Database

Warning: If your cPanel does not have GCC enabled you can not proceed with MySQL. Please tell your hosting provider to enable GCC for a smooth installation

1. Click MySQL Database Wizard.
2. Enter a name for the new database and click Next Step.
3. Create a user for this database by entering a username and creating a password. Click Create User.
4. Click the All Privileges check box or select individual privileges based on your preferences for the user. Click Next Step to continue.
5. Your Databse is created. Keep store your Database Name, Database Username and Database Password. We will need it.

### Step 2: Create a Python application in cPanel

Note: Your cPanel must have the support of Python and GCC to setup this application. The first step is to create a Python application within cPanel that will host the Django project. To do this, follow these steps:

1. Login to your cPanel
2. Open the Python app tool
   - If you are using the Jupiter theme, on the Tools page, in the Software section, click Setup Python App:
   - If you are using the Paper Lantern theme, in the SOFTWARE section of the cPanel home page, click Setup Python App:
3. Click CREATE APPLICATION:

   The application form appears:

4. In the Python version list box, select 3.7.16.
5. In the Application root text box, type 'YourAppName' eg. crm.
6. In the Application URL list box, select the domain. Leave the rest of the URL blank.
7. Leave the Application startup file text box and Application Entry point text box blank.

   > When these text boxes are blank, cPanel automatically creates a passenger_wsgi.py startup file and default application object for you.

8. In the top right corner of the page, click CREATE:

   cPanel creates the application and sets up the Python environment.

9. At the top of the page, next to Enter to the virtual environment. To enter to virtual environment, run the command, copy the command. You will need this information in the following procedure. It's look like : `source /home/username/virtualenv/YourAppName/3.7/bin/activate && cd /home/username/YourAppName`
10. Now go to the file manager of your cPanel. Locate the 'YourAppName' that you set while creating the application. A folder is created in the root directory of your file manager on that name. This is your virtual environment.
    - Download the install.zip from codecanyon
    - Upload it to the folder and unzip it.

### Step 3: Configure the Django project

After you create the Python application & MySQL database in cPanel, you are ready to do the following tasks at the command line:

- Install requirements.
- Create and configure the Django project.
- Configure Passenger to work with the Django project.
- Warning: You need GCC enabled in your cPanel otherwise you will face error while installing mysqlclient. Contact you provider if not enabled.

## Install method 01

1. In `~/YourAppName/.env` make this configurations:
   - - Make the DEBUG=False
     - Set the TIME_ZONE=Your_timezone
     - Make the MYSQL_DB=True
     - Make the WHITENOISE_CONFIG=True
     - Set the DB_NAME, DB_USER, DB_PASSWORD of your MySQL database
     - Don't forget to set the email EMAIL_HOST_USER & EMAIL_HOST_PASSWORD to work the emails.
     - Set the MEDIA_ROOT as given formet. The username in MEDIA_ROOT is your cPanel username.

         # Core
         ALLOWED_HOSTS=*
         TIME_ZONE=Asia/Dhaka
         DEBUG=False
         DEMO_MODE=False

         # Make the MYSQL_DB=True if you want to use MySQL Database
         MYSQL_DB=True

         # Make the WHITENOISE_CONFIG=True for live server
         WHITENOISE_CONFIG=True

         # MySQL Setup
         DB_NAME=database_name
         DB_USER=database_username
         DB_PASSWORD=database_user_password
         DB_HOST=localhost
         DB_PORT=3306

         # Email Credentials
         EMAIL_HOST=smtp.gmail.com
         EMAIL_PORT=587
         EMAIL_USE_TLS=True
         EMAIL_HOST_USER=host_username
         EMAIL_HOST_PASSWORD=host_password

         # Media Setup Path
         MEDIA_ROOT=/home/cpanel_username/domain.com/media

2. Go to the Setup python app in your cPanel & click the pencil icon right side of your created python app.
3. Now scroll a little and you will find add another file. In the blank field add requirements_live.txt and click add
4. Now select the requirements_live.txt from Run pip install and wait for the success message.
5. When you got the success message now enter the manage.py command in the next field and Run script and wait for complete the process.
   Here is a example of the command

       home/cpanel_user_name/YourAppName/manage.py deploy

6. Congratulations your system is ready now. You can now visit now by your domain.
7. Login to your Admin Dashboard
   Sign in using the custom login form

       https://domain.com/login/

   Or, if you want to visit Django Admin

       https://domain.com/oldadmin/

   Note: Delete the /oldadmin from your `~/YourAppName/core/urls.py` when the application is operational
8. Default Username & Password is

       Username: admin
       Password: 123456

##

## VPS Server

##### Warning: Setting up TCG AGENCY on a VPS server involves complex configurations that can impact the security and functionality of your system. It is strongly recommended to be expert on it or consult with an expert or professional before attempting installation or setup. Incorrect configurations can lead to data loss, security breaches, and other critical issues. Proceed with caution and at your own risk.

# Website

In this section we will explore the Website

## All pages overview

Note: After installing the application the website will be show blank. You have to login in the admin dashboard and add the contents.

1. #### Home Page:

   Live Preview

   Home Page Sections: The home page is composed of vital sections, each playing a specific role. The header features logo, navigation, and a prominent action button. The about section introduces company, while services showcase what company offer. Recent projects are highlighted, and fun facts engage curiosity. Testimonials build trust, and the blog imparts industry insights. The footer holds contact info and links, ensuring seamless navigation.

   Note: You need to maintain the logo size. You will get logo and other resource related topics in the Logo Settings tab

2. #### About Page:

   Live Preview

   About Us Page Sections: Discover story and team on the About Us page, thoughtfully divided into sections. Explore the intuitive breadcrumb for navigation, a concise video introduction, meet our diverse team, testimonials section of the company.

3. #### Service Page:

   Live Preview

   Service Page Sections: Explore comprehensive services through focused sections: Service Page Top (Breadcrumb), All service Section and service details page.

4. #### Project/Protfolio Page:

   Live Preview

   Project Page Sections: Navigate the portfolio effortlessly with these sections: Project Page Top (Breadcrumb), Project By Categories, and Project Details Page. Discover diverse projects, explore by categories, and delve into the specifics.

5. #### Pricing Page:

   Live Preview

   Pricing Page Sections: Explore the offerings effortlessly through these sections: Pricing Page Top (Breadcrumb) and Pricing Cards featuring our innovative Featured Making System. Navigate pricing options seamlessly and experience the unique approach.

6. #### Blog Page:

   Live Preview

   Blog Page Sections: Navigate insightful content effortlessly with these sections: Blog Page Top (Breadcrumb) and All Blogs presented individually, category wise blog filter and search by blogs. Explore a wealth of knowledge, one post at a time.

7. #### Contact Page:

   Live Preview

   Contact Page Sections: Connect effortlessly through these sections: Contact Page Top with Contact Details Cards and a Contact Form featuring a Google Map Location. Reach out, share your thoughts, and find location easily.

8. #### Terms & Condition Page:

   You can add your custom Terms & Condition from the admin dashboard. This is crucial things for a business

9. #### Privacy Policy Page:

   You can add your custom Privacy Policy from the admin dashboard. This is crucial things for a maintain the security and ensure users privacy.

# Admin Dashboard

We'll now learn details about the Admin Dashboard and how to configure the website with this custom dashboard.

Note: This dashboard is for setting up the website.

## Features & Guides

1. #### Authentication & Password Reset

   Note: This is a agency website so we didn't created the Sign Up system. Admin can create their account through the installation proccess and then can add editor or other admin from their dashboard.

2. #### Dashboard Home:

   Live Preview

   Dashboard home is used to monitor total blogs, team, project, revenue, expense etc and it has also a weather widget.

3. #### Pages:

   Note: After installing the application the website will be show blank. You have to add contents to the page from here.

   Pages Menu: You can edit your website pages and add content to them via navigate this menu. Click on each page you will get the option and navigation to add content to the page

4. #### Custom Pages:

   Custom Pages Menu: You create, update & delete custom page with title and page content from this menu.

5. #### Blogs:

   Blogs Menu: After the pages You can add, edit, delete your website blogs & blog categories from this menu.

6. #### Project:

   Project Menu: After the blogs You can add, edit, delete your website projects & project categories that are showing on the website from this menu.

7. #### Service:

   Service Menu: After the project You can add, edit, delete your website services that are showing on the website from this menu.

8. #### Elements:

   Elements Menu: This is an imporant part of the dashboard. From this elemente menu you can create, edit, delete your website's slider, testimonials, funfacts, teams, clients, pricings

9. #### Users:

   Users Menu: You can create, edit, delete users of your website with Admin & Editor roles

10. #### Form Data:

    Form Data Menu: In this menu of Form Data you can check the contact form submissions and subscribers mail and delete the data.

11. #### Menus:

    Menus: You can create, edit, delete custom primary and submenus from here.

12. #### Settings:

    - Website Settings: You can edit your website name, logo, favicon, contact details, Facebook pixel & chat code, turn on and off Messenger chat button and Whatsapp chat button and can control various settings of the website from here.

      - Logo Size: 356(width)x80(height) pixel (Recommended)
      - Favicon Size: 500(width)x500(height) pixel(Recommended)

    - Template Settings: You can select multiple templates from this menu.

    - Header Footer: You can edit your website's header footer content like your header's action button text and url. You footer's content etc from here.

    - SEO: You can add SEO meta data from here of your website for better ranking result

13. #### Marketing Tools:

    Marketing Tools Menu: From here you can do email marketing to the subscribers or non-subscribers. You will also get a email formator tool to format your unserialized emails.

14. #### Site Map:

    Site Map Menu: Your website dynamic sitemap will track every url of your front website and automatically add updated blogs, project, service, pages to the sitemap. You can use your site map to better ranking on search result. Access your sitemap by: `https://yourdomain.com/sitemap.xml`

# Resources and Credits

This are the resource credits that we used in TCG AGENCY

## Sources

#### Images:

- Unsplash - https://unsplash.com/

#### Fonts:

- Fontawesome - https://fontawesome.com/
- Ico Font - https://icofont.com/
- Box Icon - https://boxicons.com/

#### Scripts:

- jQuery - http://www.jquery.com/
- Bootstrap - http://getbootstrap.com/

# FAQs

Here is some frequently asked questions about TCG AGENCY

## ALL FAQs

##### What is TCG AGENCY?

TCG AGENCY is a comprehensive web application designed for creative agencies, developers, and businesses. It combines a stunning frontend website with a powerful admin dashboard and marketing tools.

##### Is the website responsive for all devices?

Absolutely, TCG AGENCY ensures your website looks and functions perfectly on all devices.

##### What can I manage from the admin dashboard?

You can manage website content, user roles, forms, menus, settings, and more from the admin dashboard.

##### Can I conduct email marketing campaigns?

Yes, TCG AGENCY provides email marketing tools for sending bulk emails to subscribers and non-subscribers.

##### Is subscriber management included?

Absolutely, you can manage subscribers and select specific recipients for email campaigns.

##### How does the Portfolio Showcase work?

The Portfolio Showcase allows you to display your projects and work in an organized manner. You can upload images, descriptions, and details to showcase your services and capabilities.

##### How do potential clients get in touch with me?

We offer a Contact Form through which potential clients can directly reach out to you. The form collects their information and messages, making it easier to establish new business relationships.

##### Is there customer support available for TCG AGENCY?

Yes, we offer customer support to assist you with any questions or issues you may encounter while using TCG AGENCY.

##### Is there a limit to the number of users I can manage in the dashboard?

TCG AGENCY allows you to manage an unlimited number of users based on their roles.

##### What technology stack is TCG AGENCY built on?

TCG AGENCY is built using Python Django, a powerful web framework known for its scalability and security.

# Others

This section is for the Support, Changelog and More Products

## Support

Whether this is a initial release of TCG AGENCY if you find anything trouble immediately let us know via support. We will try to fix your problem as soon as possible.

If this documentation doesn't answer your questions, So, Please send us Email via Item Support Page

We are located in GMT+6:00 time zone (Bangladesh Standard Time, BST) and we answer all questions within 12-24 hours on weekdays. In some rare cases, the waiting time can be up to 48 hours. Please note that during holiday seasons, response times might take longer.

Note: While we aim to provide the best support possible, please keep in mind that it only extends to verified buyers and only to issues related to our template like bugs and errors. Custom modifications or third party module implementations are not included.

#### Don’t forget to Rate TCG AGENCY

Please Add your Review (Opinion) for Our application. It would be a great support for us.
Go to your Codecanyon Profile > Downloads Tab > & then You can Rate & Review for our application.
Thank You.

## Changelog

For Future Updates Follow Us @codecanyon / @facebook

     v1.4 (2 Apr, 2023)
        [Added]    -  Multi Template
        [Added]    -  Visitor Analytics
        [Updated]  -  Speed Optimization
        [Fixed]    -  Runtime errors
        [Fixed]    -  Email Sending Errors

     v1.3 (30 Oct, 2023)
        [Added]    -  SMS Marketing
        [Added]    -  Custom page Creation
        [Added]    -  Project pagination
        [Added]    -  More customization flexibility
        [Updated]  -  Installation step
        [Updated]  -  SEO functionalities
        [Updated]  -  Forece full content addition removed
        [Fixed]    -  Footer service and project link issue
        [Fixed]    -  Spelling corrections
        [Fixed]    -  Runtime errors

     v1.2 (16 Oct, 2023)
        [Updated]  -  Optimization increased
        [Fixed]    -  Meta information issues
        [Fixed]    -  Spelling corrections
        [Fixed]    -  Installation bugs
        [Fixed]    -  Authentication issues

     v1.1 (1 Oct, 2023)
       [Updated] - Preloader removed
       [Fixed]   - Category wise blog read
       [Fixed]   - Authentication minor issues
       [Fixed]   - Html CSS issues

     v1.0 (23 Sep, 2023)
       - Initial Release

## More Products

##### TCG CRM

$49

Django CRM With Agency Website

View on Codecanyon

##### TCG PORTO

$29

Django Personal Portfolio With Dashboard

View on Codecanyon