Folder Structure

Before you start, you should take a look at the folder structure of InBefore package for the clear concept of what is located where.

Requirements

Before you try to install InBefore, make sure your environment meets the following requirements.

• PHP ^{7.0 to 8.3}

  Linux/unix web-server.

• Apache ^2.4+

  If you want to install on other servers like NGINX, an nginx.conf file is available.

• MySQL ^5.6+

  MySQL server with root access

• curl

  PHP Extension

• pdo_mysql

  PHP Extension

• mbstring

  PHP Extension

• dom

  PHP Extension

• fileinfo

  PHP Extension

Creating a database

First thing you need to do before installing InBefore is to create a new database on your MySQL server. The database must be created under a MySQL user that has full permissions. If you already know how to do this or have already created one you can skip to the next step. But make sure you have noted the following details:

Importing the SQL dump

After you've created the database import the SQL file provided with the script, to the database by going to phpMyadmin or any other tools. The SQL file is located at: Database/inbefore.sql.

Uploading Files

After importing the SQL file to the database, unzip the .zip file you downloaded from Codecanyon and upload the contents of Main Files folder to your server's root folder (usually called www/public_html or something similar) or a sub-directory.

Shared hosting providers usually have a web based file manager, but you should use something like FileZilla to do the upload as the web based managers can cause various problems fairly often.

Editing the database config file

After you uploaded InBefore files to your server, locate the database config file at: src/settings/db.php and open the file for editing and provide your database details that you have created earlier and save the file.

<?php
/**
 * Put your database details here after you've imported the SQL file
 *
 * @return array
 */
return [

   // Database host. Usually localhost or 127.0.0.1
   'dbhost' => 'localhost',

   // Database name
  'dbname' => '',

  // Database Username
  'username' => 'root',

  // Database password
  'password' => '',

  // 3306 in most cases
  'dbport' => '3306',

  //DON'T CHANGE THIS
  'prefix' => 'in_',
];

And... you're done. That's it. Now you can access your site's admin dashboard by visiting: https://yoursite.com/dashboard.

How to Upgrade

The upgrade files are located in Upgrades folder in the package you've downloaded from Codecanyon. The files are located in version specific order, to check what version you currently have installed. Open the file src/constants.php and look up the constant APP_VERSION.

Now, to upgrade just replace the files to your current installation. If there's any SQL file present within the folder, you'd need to run it in your current database via phpmyadmin usually.

Major Upgrades

Customizing the site

You can change the site name, description, logo and other basic information by navigating to: Settings > General from the dashboard.

To customize even more specific features like how many items will be shown and other frontend aspects that directly affect the site you will need to go to: Settings > Site from the dashboard.

Adding new Engines

Engines are mainly different Google Custom Search Engines created by you. InBefore already comes with 5 preloaded engines. However, you may add as many engines you want. To add new engine first you will need a Google Custom Search Engine ID.
To add new engines go to Dashboard > Engines and click the Create button.

Setting up cron-job

To setup the cron job first you will need to get the cron command from the dashboard by going to Settings > Debugging. Once you have the cron command copy it and setup the cron job from your cPanel.

Translating

Language files should be and are located at site/themes/default/languages folder.

To create a new translation, copy existing translation file, and use these locale name create your own locale file. For example for English(UK), create a new directory named "en_UK", copy the en_US.php file and paste on the "en_UK" folder and rename as "en_UK.php", then start editing. Please note if you don't use the locale name given here for the locale directory/file name, it won't work.

So basically translation files should look like this: (Case sensitive)

• <LOCALE>/<LOCALE>.php
• en_US/en_US.php
• bn_BD/bn_BD.php

Supported Locales

Plugins: Sitemap and RSS Feed

To enable sitemaps and RSS feed, go to Dashboard > Plugins and enable the "Sitemap and RSS" plugin. Then click on the plugin options to manage and see the sitemap and rss URLs.

Common Issues

It shows 403 Forbidden error when accessing the site

That's because your file manager ignored the .htaccess file, it can happen because cPanel filemanager by default has the option "Show hidden (dotfiles)" disabled. So, always make sure the .htaccess file is present at the very first.

It shows "This page isn't working", "Error 500"

This could happen because of numerous reasons, for example if the PHP version doesn't match, one or more of the required extensions are not enabled. To check what's causing the error, open the file: src/constants.php file and set the constant DEV_MODE to true, like this: define('DEV_MODE', true);. Alternatively you can check the log files from here: src/var/logs/. And solve the issue according to the error message. If you still can't figure out the issue or resolve it, please do let me know.

When I save ad-codes or header/footer scripts, it won't save anything.

Your server has ModSecurity enabled. And it prevents users from submitting codes via POST/GET requests. So, to solve the issue, you will need to disable ModSecurity from your domain. If you can't do it, you'd need to contact your server/hosting provider to do it for you.

Frequently Asked Questions

How do I get an Google CSE ID?

To get a Google CSE ID follow these steps:

• 1. Sign in to your Google account and go to https://cse.google.com/cse/create/new

• Provide the site domains and URL patterns you want to perform search. You can always change them later. Then click CREATE.

  

• 2. After the CSE has been created, visit its control panel by clicking the button Control Panel on the next page.

• 3. On the control panel you'll find the Google CSE ID. You can copy it and use in the app now.

  

How do I edit site's styles and templates?

Site templates, styles are located in the site/themes/default folder. You can modify everything from there. Just make sure to keep a copy of the original files.

Why do some feeds don't work?

Not all feeds can be parsed via SimplePie. There are very few exceptional feeds that can cause problems.

Why some images are not showing from imported content

Some sites don't allow hotlinking the images, in those cases the images can be broken.

Support Criteria

Support for our items includes:

• 1. Responding to questions or problems regarding the item and its features
• 2. Fixing bugs and reported issues
• 3. Providing updates to ensure compatibility with new software versions

Item support does not include:

• 1. Customization and installation services
• 2. Support for third party software and plug-ins

Before seeking support please..

• 1. Make sure you've purchased the item. Pirated items won't get any support, duh!
• 2. Make sure your question is a valid item Issue and NOT a customization request.
• 3. Make sure you have read through the documentation before asking support on how to accomplish a task.
• 4. Make sure to double check the item FAQs.
• 5. If you have customized your item and now have an issue, back-track to make sure you didn't make a mistake. If you have made changes and can't find the issue, please provide us with your changelog.
• 6. Almost 80% of the time we find that the solution to people's issues can be solved with a simple "Google Search". You might want to try that before seeking support. You might be able to fix the issue yourself much quicker than we can respond to your request.
• 7. Make sure to state the name of the item you are having issues with when requesting support via Codecanyon.