The quickest way to install Awesome Studio plugin is by going to our 'Install' page, and specifying URL where you want to install. In case that option does not work, you can download the plugin directly from WordPress.org, and follow the detailed instructions for manually installing Awesome Studio.

Awesome Modules are the basic building blocks of a page within Awesome Studio platform. Within a website we first identify all the modules we need then we create/install them for use. We then use these ready modules to quickly assemble new layouts for our pages. Here is how you can create and use a module.

1. create a global module :
   1. Click on 'Awesome Studio'  in the left panel and then click on 'Global Modules'.
   2. Click on 'Add Awesome Module'
   3. Let's Give our module a title, 'hello-awesome', we generally write the title in small letters and without spaces to ensure that the slug and title for the module are same making it easier to remember the slug of a module. We use the slug to refer these modules.

   4. [aw2.set module.post_class='{{aw2.get module.slug}}_post' module.post_unique_class='{token}' /]
      [aw2.client less]
        .[aw2.get module.post_unique_class /]{
          border: 1px dotted [aw2.get module.border-color /];
        }
        
        .[aw2.get module.post_class /] {
          .section-title{
      		background-color:#000;
      		color:#fff;
      	}
      	.intro{
      		color:#000;
      		border: 1px solid red;
      		margin:2px;
      	}
           
        }
      [/aw2.client]
       
      <div class="[aw2.get module.post_unique_class /] [aw2.get module.post_class /] [aw2.get module.class /]">
      	<section title='[aw2.get module.slug /]'>  
      	  <h2 class='section-title'>[aw2.get module.section_title /]</h2>
      	  <p class='intro'>[aw2.get module.introduction /]</p>
      	</section>	
      </div>

       
   5. Click the publish button, you can also use 'crtl+s' to save the modules
2. calling it within a page
   1. Now you have a published module that can be used within page or another module. let's see how to use awesome module.
   2. Click on pages -> add new page on the left panel.
   3. Give it a title "Test Awesome Module"
   4. In  the content area type following

      [aw2.module slug="hello-awesome"]
      	[aw2.this module.section_title="Hello Awesome" /]
      	[aw2.this module.introduction]
      	 By creating a awesome module, you keeep all the dependecy of module in one place making it easier to maintain and change in future.
      	[/aw2.this]
      [/aw2.module]

       
   5. By using aw2.module you call a module, and by using aw2.this within aw2.module you can set the parameters of the module.
   6. Save the page, and view this page.
   7. Now let's call this module again within the same page

   8. [aw2.module slug="hello-awesome"]
      	[aw2.this module.section_title="Hello Awesome" /]
      	[aw2.this module.introduction]
      	 By creating a awesome module, you keeep all the dependecy of module in one place making it easier to maintain and change in future.
      	[/aw2.this]
      [/aw2.module]
      
      [aw2.module slug="hello-awesome"]
      [aw2.this module.border-color="#00ee00"]	
      [aw2.this module.section_title="Awesome Again" /]
      	[aw2.this module.introduction]
      	This is same awesome module, called again within the page
      	[/aw2.this]
      [/aw2.module]

       
   9. Save the page and check again. This is how we create and use a awesome module.
3. calling it within another module

1. Register your App (better install blank app from catalouge)
2. Create App specific module
3. Call them inside the App specific pages.
4. Visit the App URL to see it working

In this guide we will see how to quickly and easily setup a webserver for running your WordPress website. We will be setting up Nginx, MariyaDB and PHP 7 on a Ubuntu server, then we will setup LMD and ClamAV to reduce malware infection and configure fail2ban to block these attempts to infect the website. Finally, we will see how to quickly setup S3 based WordPress backup. So, let's gets started.

Let's start by installing easyengine, it will help us setup rest of the things.

1. wget -qO ee rt.cx/ee && sudo bash ee # install easyengine
2. ee stack install

We prefer to use Maradb10.2 of we will install that

1. ee stack remove --mysql
2. nano /etc/apt/sources.list.d/ee-repo.list to edit the file and change the value from 10.1 to 10.2 for mariadb.
3. ee stack install --mysql
4. mysql -V
5. you can get the root password at /etc/mysql/conf.d/my.cnf

Now, setup the domain with PHP 7

1. ee site create nxt.smartinstitute.net --wpfc --php7
2. nano /etc/nginx/common/wpfc-php7.conf and add aw2_vsesssion in $http_cookie line.

Let's setup composer on the server  

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('SHA384', 'composer-setup.php') === '93b54496392c062774670ac18b134c3b3a95e5a5e5c8f1a9f115f203b75bf9a129d5daa8ba6a13e2cc8a1da0806388a8') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"

mv composer.phar /usr/local/bin/composer

Let's make sure PHPMyAdmin is properly setup

cd /var/www/22222/htdocs/db/pma
composer update --no-dev

  Now let's setup Redis

1. add-apt-repository ppa:chris-lea/redis-server
2. apt-get update
3. apt-get install redis-server php-redis

phpRedisAdmin

1. mkdir /var/www/22222/htdocs/cache/redis && cd /var/www/22222/htdocs/cache/redis
2. git clone https://github.com/ErikDubbelboer/phpRedisAdmin.git
3. cd phpRedisAdmin
4. git clone https://github.com/nrk/predis.git vendor

WordPress Object Cache

1. cd /var/www/example.com/htdocs/wp-content
2. wget https://raw.githubusercontent.com/alleyinteractive/wp-redis/master/object-cache.php
3. chown www-data: object-cache.php

Block XML-RPC

1. nano /var/www/yourdomain.ltd/conf/nginx/xmlrpc.conf
2. And to add the following content in this .conf file :

location = /xmlrpc.php {
 deny all;
 access_log off;
 log_not_found off;
}

Disbale Cache-Control This step is very specific for our use case (ie if you are using awesome studio plugin) , please ignore if not applicable to you.

1. nano /etc/nginx/conf.d/fastcgi.conf
2. On line number 9 you will find follwoing line

   fastcgi_ignore_headers Cache-Control Expires Set-Cookie;

3. repalce it with follwing line and save the file

   fastcgi_ignore_headers  Expires Set-Cookie;

4. And run the command

   service nginx reload

Let's enable SSL using letsencrypt

1. ee site update nxt.smartinstitute.net --letsencrypt
2. which ee  #to find the exact path of ee
3. crontab -e
4. update cron line to 0 0 * * 0 /usr/local/bin/ee site update --le=renew --all 2>> /var/log/ee/renew.log # Renew all letsencrypt SSL cert. Set by EasyEngine

We will be using Maldetect and ClamAV for virus and malware scaning to pervent infection on the server.

1. wget http://www.rfxn.com/downloads/maldetect-current.tar.gz
2. tar -zxvf maldetect-current.tar.gz
3. cd maldetect-1.6.2/
4. ./install.sh
5. apt-get install apparmor-utils
6. apt-get install inotify-tools
7. apt-get install clamav
8. apt-get install clamav-daemon
9. aa-complain clamd
10. service clamav-daemon start
11. nano /usr/local/maldetect/conf.maldet
12. nano /usr/local/maldetect/monitor_paths
13. nano /usr/local/maldetect/ignore_file_ext
14. service maldet start

 

We use Fail2ban to parse log files and block IP address of malicious requests, just set up the fail2ban.

apt-get install fail2ban

After that simply add the following lines to jail.conf file.

jail.conf
--------------
[wordpress]
enabled  = true
port     = http,https
filter   = wordpress-auth
logpath  = /var/log/nginx/access.log
		   /var/log/nginx/wpoets.com.access.log
		  
maxretry = 2
bantime  = 3600

[wordpress-extras]
enabled  = true
port     = http,https
filter   = wordpress-extras
logpath  = /var/log/nginx/access.log
		   /var/log/nginx/wpoets.com.access.log
		  
maxretry = 1
bantime  = 43200

you will need to adjust the logpath above to point to actual log path on your server. maxretry is used to define the number of attempts before banning and bantime is used to define the number of seconds to ban the IP address.   Now create wordpress-auth.conf and wordpress-extras.conf file within filter.d folder using code mentioned below, you can put your own regex pattern in failregex key.

wordpress-auth.conf
---------------------

[Definition]
failregex = <HOST>.*POST.*(wp-login\.php|xmlrpc\.php).* 403
            <HOST>.*POST.*\/wp-content\/.*\.php
ignoreregex =

 

wordpress-extras.conf
----------------------------
[Definition]
failregex = <HOST>.*POST.*\/wp-content\/.*\.php
	    <HOST>.*POST.*\/wp-includes\/js\/.*\.php
	    <HOST>.*GET.*\/Purchase-2017
	    <HOST>.*GET.*\/Holidays-Card
	    <HOST>.*GET.*\/Outstanding-INVOICE-VVX
	    <HOST>.*GET.*\/oboskej
	    <HOST>.*GET.*\/vlnoeiw
	    <HOST>.*GET.*\/vlaofr
	    <HOST>.*GET.*\/ljysix
	    <HOST>.*GET.*\/journal\/y5eh2\.php
	    <HOST>.*GET.*\/blnoitez
	    <HOST>.*GET.*\/updatecorex\/
	    <HOST>.*GET.*\/wp-caches\.php
		<HOST>.*POST.*(wp-login\.php|xmlrpc\.php).* 499
		<HOST>.*POST.*\/wp-includes\/images\/.*\.php
		<HOST>.*POST.*\/wp-admin\/css\/colors\/.*\.php
		<HOST>.*POST.*\/wp-includes\/rest-api\/fields\/.*\.php
		
		

ignoreregex =

Finally just restart fail2ban using

service fail2ban restart

In case you get an error while restarting, make sure you don't have the jail.local file, in case it is present make it blank.

Prerequisites

EasyEngine v3 or above

Installing

Create the wordpress site by using EasyEngine for EE3

ee site create example.com --wp

for EE4

ee site create example.com --type=wp --cache

Download this script for EE3

wget "https://raw.githubusercontent.com/WPoets/aw-setup/master/ee3-setup.sh"

for EE4

wget "https://raw.githubusercontent.com/WPoets/aw-setup/master/ee4-setup.sh"

Make it executable for EE3

chmod u+x ee3-setup.sh

for EE4

chmod u+x ee4-setup.sh

Running the Script

Use below command to configure any wordpress site with Awesome Enterprise for EE3

./ee3-setup.sh example.com

for EE4

./ee4-setup.sh example.com

After running this command this script will ask the redis database no. enter the appropriate database no.

Adding new WP user

To add new WP user this script will promt you to register new user. enter y to add new user and follow the procedure.

Enabling the EE Admin-Tools(Only available in EE4)

To enable the admin tools enter y when this script ask to enable the admin tools.