Development Guide

Documentation - v1.0

Softora - IT Solutions & Technology HTML Template

The Softora is a Static HTML5 Template:
We do not provide any documentation or email support on how to integrate with any CMS (such as WordPress, Joomla, etc.) or frameworks (such as Angular, Vue, React, Laravel etc.).

Get Help

Thank you for purchased our item(s). If you have any questions that are beyond the scope of this help file, please feel free to email via support page here. Thank you so much!

In some cases, you may have to wait 2 working days to get an email answer. However, we will try to answer you as soon as possible. Replies are sometimes delayed due to multiple emails and time zone variations.

Files Structure

  • Softora
    • dist (compiled distribution files)
    • node_modules (npm dependencies files. It is NOT included in the downloaded file, this folder will be installed automatically when you install npm).
    • src (all source files)
      • html (all .html files into this folder)
      • scss (all .scss files into this folder)
    • static (all static assets)
      • img (all images)
      • js (all static .js files)
    • .browerslistrc
    • changelog.txt
    • gulpfile.js
    • license
    • package.json
    • package-lock.json

Code Editor

There are many code editors for web code editing. You can use whatever you want. We recommend that you use Visual Studio Code . Because - this template is coded using it.

Installation

It has a directory (Softora/dist) of compiled files. If you want to edit without source files (plain HTML/CSS/JS files), you do not need to install anything on your machine.

You need to install package files/dependencies for this project if you want to customize it. To do this, you must have node and npm installed on your computer. Installation guide of the node can be found here.

As npm comes bundled with a node, a separate installation of npm is NOT needed. If you have installed them, just go to the root folder and run the following command in your command prompt or terminal.

npm install

Run Gulp

Run a command to run Gulp. When you run this command, it also watching at all source and static files. So, you don't need to run another command to watching these.

npm run dev

If you want, just watch the source files. You can run another individual command.

npm run dev watch

Know the file type

Source files:

Source files are files that are processed with template build tools to make the browser readable. E.g. SCSS & row HTML files always source files.

Files location: Softora > "src" folder

Compiled files:

Compiled files are files generated as a result of running a compilation process in the source files. E.g. CSS & standard HTML files always compiled files.

Files location: Softora > "dist" folder

Static files:

Static files are ones that aren't processed or generated. E.g. Images, Web Icon Fonts and standard HTML are static files.

Files location: Softora > "static" folder

How to edit the Title & Favicon?

Open the mail file (Softora) in your code editor. Then open index.html file & customize as your desire.

File location: Softora > src > html > index.html

Customize with Complied Files

Open any *.html file & customize as your desire.

File location: Softora > dist > *.html

Remember: The page you will edit, the change will be only that page. So, you need to edit all the HTML files.

How to edit the Brand Logo?

Open the mail file (Softora) in your code editor. Then open index.html file & customize as your desire.

File location: Softora > src > html > index.html

Customize with Complied Files

Open any *.html file & customize as your desire.

File location: Softora > dist > *.html

Remember: The page you will edit, the change will be only that page. So, you need to edit all the HTML files.

How to edit the Footer Nav?

Open the mail file (Softora) in your code editor. Then open index.html file & customize as your desire.

File location: Softora > src > html > index.html

Customize with Complied Files

Open any *.html file & customize as your desire.

File location: Softora > dist > *.html

Remember: The page you will edit, the change will be only that page. So, you need to edit all the HTML files.

How to edit the template Colors?

Open the mail file (Softora) in your code editor. Then open _colors.scss file & customize as your desire.

File location: Softora > src > scss > _colors.scss

Customize with Complied Files

Open style.css file & customize as your desire.

File location: Softora > dist > style.css

Customize with Complied Files

Working with compiled files is very easy. You don't need any build tools or local setup to edit the template. A folder (Softora/dist) is already provided with the template. Open this folder and edit it as your desired.

Recompiling will overwrite your all changes!

When you will customize with compile files, please do not run the template build tools. If you run the template build tools again, all your changes will be overwritten.

Third Party Plugins Activation

Name Plugins Activation Code
Swiper Slider
const teamSwiper = document.querySelector('.team-swiper');

if (teamSwiper) {
    new Swiper('.team-swiper', {
        loop: true,
        spaceBetween: 30,
        slidesPerView: 4,
        autoplay: {
            delay: 5000,
            disableOnInteraction: false,
        },
        navigation: {
            nextEl: '.team-button-next',
            prevEl: '.team-button-prev',
        },
        breakpoints: {
            320: {
                slidesPerView: 1.5,
                spaceBetween: 10,
            },
            480: {
                slidesPerView: 2,
                spaceBetween: 20,
            },
            576: {
                slidesPerView: 2.5,
                spaceBetween: 20,
            },
            768: {
                slidesPerView: 3,
                spaceBetween: 20,
            },
            992: {
                slidesPerView: 4,
                spaceBetween: 20,
            }
        },
    });
}
Counter Up
let counterlen = document.querySelectorAll(".counter").length;

if (counterlen > 0) {
    let counterUp = window.counterUp.default;

    let callback = entries => {
        entries.forEach(entry => {
            let counterElement = entry.target
            if (entry.isIntersecting && !counterElement.classList.contains('is-visible')) {
                counterUp(counterElement, {
                    duration: 2000,
                    delay: 20
                });
                counterElement.classList.add('is-visible');
            }
        });
    }

    let IO = new IntersectionObserver(callback, {
        threshold: 1
    });

    let counterUpClass = document.querySelectorAll('.counter');
    let counterUpClasslen = counterUpClass.length;

    for (let i = 0; i < counterUpClasslen; i++) {
        IO.observe(counterUpClass[i]);
    }
}
Search Form
const searchButton = document.getElementById('searchButton');
const searchClose = document.getElementById('searchClose');
const searchFormPopup = document.querySelector('.search-form-popup');
const searchOverlay = document.getElementById('searchOverlay');

if (searchButton) {
    searchButton.addEventListener('click', () => {
        searchFormPopup.classList.add('open');
        searchOverlay.classList.add('open');
    });
    searchClose.addEventListener('click', () => {
        searchFormPopup.classList.remove('open');
        searchOverlay.classList.remove('open');
    });
}

Changelog(s)

Version 1.0.0
  • Initial Release