General settings

Introduction

Those configurations are used to manage vaahCMS can be set in this General settings section. Here controls are segregated in 6 parts in accordion, will discuss one by one.

Visit following url you will see the General settings section:

<public-url>/backend#/vaah/settings/general

Below Image is a example of General settings.

Site Settings

In this setting we are configuring the behavior of the application.

Below Image is a example of Site settings.

Follow the lists below to know about site settings

After set all the configuration you need to click on Save Setting button to achieve those effect. There is also Clear Cache button which will help user to clear by pressing a button, after that it will log out and take to the login page.

Below video will help to understand about site settings :

Securities

This setting provides Multi-Factor Authentication Securities to the site during the login.

Below image is of Securities settings.

In the above image you can see there are 3 options available:
1.Disable

2.Enable for all users

3.Users will have options to enable it

We will get to know about all of these methods one by one

1. Disable:

When you enable this option, then users will be able to login directly with their userID and password.

2. Enable for all users

When you enable this option, then you also need to choose MFA Methods by which the users will be verified when they login to the VaahCMS.
Currently we have got three MFA methods in VaahCMS for verifying the users:

1. Email OTP Verification
2. SMS OTP Verification
3. Authenticator App

Follow below image for reference:
If you choose Email OTP Verification then the user will also need to enter the OTP which will be sent to their email when the user try to login. After selecting the option you also need to click on save button.
Follow below image for reference:

After entering the OTP you need to click on Submit OTP button, then you will be successfully login to the VaahCMS.
Follow below image for reference:

3. Users will have options to enable it

In this method the users will have the option to enable it. For this they will need to go to their profile section.

Follow below image for reference:

In the profile section,they will need to scroll down and check the Email otp verification checkbox and click on Save MFA button.
Follow below image for reference:

Once they enable Multi-Factor Authentication from their profile section, then they will also need to enter the OTP which will be sent to their email when they try to login.
Follow below image for reference:

After entering the OTP you need to click on Submit OTP button, then you will be successfully login to the VaahCMS.
Follow below image for reference:

Date & Time

This setting is to set the format of the date, time and date&time. Each format get a dropdown, where some fixed formats are there. Also there is custom option available to avail user defined format.

Below image is of Date & Time settings.

After set the format of the Date and Time you need to click on the Save.

Social Media & Links

This is for managing social media and its links.

Below image is of Social Media & Links settings.

Here one can add new social media link also remove old one if not useful. Watch the video below to know How to Manage social media & its links :

Scripts

In this section you can put Google Analytics script tags. Here we can put tags in two parts, one inside head and another one inside body.

Below image is of Scripts settings.

After put tags inside these four fields click on Save to store the configuration for Script Tag

Meta Tags

VahhCMS has meta tag updating section where we can add our custom meta tag. VaahCMS presents two meta tags, which is Google Webmaster & Open Graph(Facebook).

Below image is for reference:

One can add a tag by clicking Add Meta Tag button. It will add a tag there you need to define some property.

Below video will help you to understand how to add a Meta Tag:

How to create Setting

You can create a Setting through Seeds and add a field on Setting Form for that Setting.

Create a json file of name settings.json at <module>/Database/Seeds/json/ this directory.

Write this code in settings.json file.

[

    {
        "category": "global",
        "key": "site_title",
        "value": "VaahCMS"
    },
    {
        "category": "global",
        "key": "site_description",
        "value": "Another awesome site on VaahCMS"
    }

]

You have to create seedSetting() method in DatabaseTableSeeder.php file.To run this seed, And you have to Deactivate and Activate you Module

 function seeds()
    {
     $this->seedSettings();
    }

public function getListFromJson($json_file_name)
    {
        $json_file = __DIR__."/json/".$json_file_name;
        $jsonString = file_get_contents($json_file);
        return json_decode($jsonString, true);
    }

public function seedSettings()
    {


        $list = $this->getListFromJson("settings.json");

        foreach($list as $item)
        {
            $exist = \DB::table( 'vh_settings' )
                ->where( 'category', $item['category'] )
                ->where( 'key', $item['key'] )
                ->first();

            if (!$exist){

                if(isset($item['type']) && $item['type']=='json')
                {
                    $item['value']=json_encode($item['value']);
                }

                \DB::table( 'vh_settings' )->insert( $item );
            } else{
                \DB::table( 'vh_settings' )
                    ->where( 'category', $item['category'] )
                    ->where( 'key', $item['key'] )
                    ->update($item);
            }
        }

    }