Introduction

Jobcy is a simple and well-organized job listing Template built-in Python, Django & Bootstrap version 5.3.2.

Jobcy contains lots of new designs of jobs pages with responsiveness on all screens. Additionally, we have given 3 different color variants, you can easily change variants in your running application. We have written minimum SCSS and codes to increase performance.

Make sure to have the Python installed & running in your computer. If you already have installed Python on your computer, you can skip this step. Please use Python version 3 or if you are using Python version 2 then make sure to run all the below commands with python insted of python3. If you are using Windows OS then please install using APP store.

If you have any questions that are beyond the scope of this documentation, please feel free to email or contact us via our profile page or sent email on themesdesign.in@gmail.com

📁 Folder & Files Structure
├── Documentation
├── Jobcy
    ├── blog
    ├── company
    ├── contact
    ├── jobcy
    ├── pages
    ├── src
        ├── fonts
        ├── images
        ├── js
        ├── scss                                                        
    ├── static
        ├── css                                                        
        ├── fonts
        ├── images
        ├── js
        ├── libs                                                             
    ├── templates
    ├── db.sqlite3
    ├── gulpfile.js
    ├── manage.py
    ├── package.json
    ├── yarn.lock

Setup Django

Prerequisites

Please follow below steps to install and setup all prerequisites:

  • Yarn

    You must have Yarn installed & running on your computer. If you already have it, ignore this step. We recommend Yarn instead of NPM.

  • Nodejs

    jobcy requires Node.js installed on your computer. Make sure the version of Node Js is greater than 18. Use the LTS Version for the Node Js.

  • Gulp

    Make sure you have Gulp installed & running on your computer. If you already installed gulp, run command npm install -g gulp from your terminal.

  • Git

    You must have Git installed & running on your PC. Installation For setting up the Landing theme, follow the below process.

  • Python

    Make sure to have the Python installed & running in your computer. If you already have installed Python on your computer, you can skip this step. Please use Python version 3 or if you are using Python version 2 then make sure to run all the below commands with python insted of python3.

    For windows
    • Download python from windows store
    • Select the Python's version to download.
    • Click on the Install Now
    • Installation in Process
    For Linux
    • sudo apt update
    • sudo apt install python3

  • Check Pip version

    py -m pip --version
    upgrade pip
    py -m pip install --upgrade pip

  • Virtualenv

    Make sure to have the virtualenv installed globally & running on your computer. If you already have installed on your computer, you can skip this step.

    Virtualenv installation command for linux & mac os
    python3 -m pip install --user virtualenv
    Virtualenv installation command for Windows
    py -m pip install --user virtualenv

Installation

To setup the Landing theme, follow below-mentioned steps:

  • Install Prerequisites

    Make sure to have all above prerequisites installed & running on your computer

After you finished with the above steps, you can run the following commands into the terminal / command prompt from the root directory of the project to run the project locally or build for production use:

Command Description
python3 -m venv env_name Create Virtual Environment on linux & mac OS
python -m venv env_name Create Virtual Environment on Windows OS
source environment_name/bin/activate Activate Environment on Linux & mac OS
environment_name\Scripts\activate Activate Environment on Windows OS
pip3 install django Install Django on linux & mac OS
pip install django Install Django on Windows OS

Note: Depending on your installation, you may need to use either pip3 or pip and for python you may need to use either python3 or python.

After you finished with the above steps, you can run the following commands into the terminal / command prompt from the root directory of the project to run the project locally:

  • Database Connectivity

    Goto settings.py of main directory and update below settings.

    DATABASES = {
        'default': {
        'ENGINE': 'django.db.backends.#databaseservername#',
        'NAME': 'Your Database Name',
        'USER' : 'Database User Name',
        'PASSWORD' : 'Your Password',
        'HOST' : 'Write down Host',
        'PORT' : 'Write down port',
        }
    }
    
  • Run below command for database migration
    For Windows: python manage.py migrate
    For Linux: python3 manage.py migrate
  • To create a superuser run the below command
    python manage.py createsuperuser
    enter username Your Username
    enter your Email Address
    enter your Password
    enter your Password again

  • Note: After open terminal and enter command gulp
  • Run below command for run your project
    For Windows: python manage.py runserver
    For Linux: python3 manage.py runserver
  • To load static files
    Go to Jobcy/setings.py and add following command:-
    STATIC_URL = '/static/'
    STATICFILES_DIRS = [os.path.join(BASE_DIR,'static')]
    STATIC_ROOT= os.path.join(BASE_DIR,'assets')
    python manage.py collectstatic
  • SMTP CONFIGURATION

    Go to Wozia/settings.py and update credential

    EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
    EMAIL_HOST = 'smtp.gmail.com'
    EMAIL_PORT = 587
    EMAIL_USE_TLS = True
    EMAIL_HOST_USER = 'YOUR EMAIL ADDRESS'
    EMAIL_HOST_PASSWORD = 'YOUR HOST Password'
    DEFAULT_FROM_EMAIL = 'YOUR EMAIL ADDRESS'

Green Version (Default Version)

The green color version is a default version set by color="green" at line number 31 in the src/js/pages/switcher.init.js .


Blue Version

The Blue color set by color="blue" at line number 31 in the src/js/pages/switcher.init.js .


Purple Version

The Purple color set by color="purple" at line number 31 in the src/js/pages/switcher.init.js .


Light Mode

The Light color set by data-bs-theme="light" to body tag in the partials/base.html


Dark Mode

The Dark color set by data-bs-theme="dark" to body tag in the partials/base.html


Set Default home page

  • Index 1

    Go to Jobcy/urls.py.
    and update code path('', views.Index.as_view(),name='index') at line number 24.

  • Index 2

    Go to Jobcy/urls.py.
    and update code path('', views.Index2.as_view(),name='index') at line number 24.

  • Index 3

    Go to Jobcy/urls.py.
    and update code path('', views.Index3.as_view(),name='index') at line number 24.


manage.py Structure


Tips

SCSS: We suggest you not to do any changes in any scss files from src/scss/custom folders because it will trouble in future updates so we are suggesting that if you want to make any changes you can create a new custom.scss file and use that instead of the theme's file. If you have any questions beyond this documentation, feel free to contact us at themesdesign.in@gmail.com


Changelog

v1.1.0 - 28 Dec 2023

  • Python version updated to 3.12.0.
  • Django version updated to 5.0.0.
  • Bootstrap version updated to 5.3.2.
  • Fixed Minor Issues

v1.0.0 - 25 April 2022

  • Initial released
© Themesdesign.
Crafted with by Themesdesign