Wordpress 3.x - 4.x Installation

Step 1: Upload New Plugin into WP-Admin and Activate

Step 2: Click Settings-> Awesome Media Gallery

Step 3: Enter the sub-directory (slug) that you want to install AMG

Step 4: Click on the link which appears (ie. http://your-wp-site.com/gallery-slug)

Step 5: Finish the installation process and you're done!

**Step 6: Return to the Mokoala admin panel anytime in your WP Dashboard Menu

**Step 7: Install the oAuth Provider Plugin to let your WP Users automatically log into AMG


Does this Plugin Come With A Wordpress Theme?

This plugin will install the default AMG theme that is shown on the demo site. Complete styling options can be found in the Admin Settings. The site design can be easily changed using CSS (LESS css).


Can I Restrict Access to my existing WP Users?

Yes, AMG supports a strict access setting for existing WP Users only. It can force visitors to sign up to your WP site before being able to view or upload on AMG.


How Do I Access The Admin Panel?

Goto AMG Admin & Settings in your WP-Admin Dashboard Menu.


Can I Control AMG Using the Wordpress Panel?

Yes, but you have to use the Mokoala CMS. This plugin runs independently from your Wordpress installation, however it stores its database tables within the Wordpress database. It also uses oAuth to seamlessly integrate your existing users.


Can I setup AMG as the home page of my Wordpress Site?

Option A: You can redirect your home page to the AMG slug. Install this free plugin: http://wordpress.org/plugins/redirection/ and in the settings write '/' for the Source URL, and write '/AMG-SLUG-HERE' for the Target URL. Save the settings and your done!

Option B: If option A doesn't work right for some reason. Try this manual solution by inserting the following code into your HTACCESS file in the root of your WP installation. Don't forget to replace yourdomain and your-home-slug. Delete your-home-slug if your home page is '/'.

    RewriteCond %{HTTP_HOST} yourdomain\.com [NC]
    RewriteCond %{REQUEST_URI} ^/$
    Rewriterule ^(.*)$ http://yourdomain.com/your-home-slug [L,R=301]

I'm getting an error during install, what's up?

On some server setups, the HTACCESS file might not exist and/or might not have the right file permissions. If you're getting an error after inputting your slug, disactivate and delete the plugin. Then use your FTP to access the root of your wordpress installation and make sure the .htaccess file has file permissions set to 0777. Once set, reupload and install the WP plugin and set another slug. If you continue having issues, be sure to submit a support ticket here.


How can I manually configure the HTACCESS for my Wordpress Site?

Note: The following presumes that wordpress is installed in the root and not sub folder. You may need to set RewriteBase to /FOLDERNAME if Wordpress is installed in a separate folder to your root website directory.

Ensure you have a file called .htaccess in the root of your wordpress installation.
Set permissions of this file to 0777.
Open up htaccess.

Copy the following code above the existing Wordpress rules:

    #AMG PLUGIN CODE#
    <IfModule mod_rewrite.c>
    RewriteEngine on
    RewriteBase /
    RewriteRule ^YOURSLUG/(.*)$ wp-content/plugins/awesome-media-gallery/amg/$1$2 [L]
    RewriteCond %{REQUEST_URI} ^/YOURSLUG$
    RewriteRule YOURSLUG YOURSLUG/ [R,L]
    </IfModule>
    #AMG PLUGIN CODE#

Replace YOURSLUG with the slug of your choice. Remember not to choose one Wordpress is already using.


When I click on a member name - it goes to a page not found... How do I fix this?

Some servers require a tweak to the /member.php page in the AMG Plugins directory.

Replace the following line:

    $parts = explode($config->site->url, $url);

With this one :

    $parts = explode('http://' . $_SERVER[HTTP_HOST] . '/wp-content/plugins/awesome-media-gallery/amg/', $url);

I'm having an issue with WP-Engine... how do I make it work on the Live server?

WP-Engine is not recommended for AMG since the staging and live setups work differently and doesn't use APACHE or CPANEL. You can try adding the following Redirect Rule In the Wp-Engine settings:

Source: ^/REPLACE-WITH-YOUR-SLUG/(.*)$
Destination: /wp-content/plugins/awesome-media-gallery/amg/$1