Documentation

Installation / Installation PHP

Installing MoxieManager should be fairly simple, but mastering all the options can be harder.

Requirements

PHP version of at least 5.3 is required for MoxieManager to work properly

For PHP 7, you need at least version 2.0.10 of MoxieManager.

As for other PHP extensions, GD image library is required if you wish to use any image editing capabilities.

Exif extension is also recommended but Exif features can be turned off, basically only used to extract a thumbnail if it exists.

Any "normal" browser that isn't to old should work just fine with MoxieManager, older browser versions might have a different look though.

A modern HTML5 or HTML4 Strict doctype (<!DOCTYPE html>) is required to get the UI to render properly.

Weird shared hosting PHP security settings (mostly really bad shared hosting setups) can cause various permission issues.

Basic Installation

Here are the basic steps for installing the moxiemanager in standalone mode.

  1. Unpack the zip file and upload it to your web server. For example: c:/inetpub/wwwroot/moxiemanager
  2. Open the moxiemanager in a browser for example http://localhost/moxiemanager/
  3. Follow the instructions in the installer, it will create the config.php file for you.

The next step is to configure it exactly as you might want it.

TinyMCE Installation

Installing as a plugin to TinyMCE is also fairly simple.

  1. Locate your TinyMCE folder
  2. Locate your TinyMCE config options (wherever they may be in whatever system you are using), should look something like this tinymce.init{/*... lots of config options ...*/}
  3. Unpack MoxieManager into your tinymce/plugins folder, so it ends up in tinymce/plugins/moxiemanager.
  4. Edit the tinymce.init{} and insert "moxiemanager" into the plugins list, should look something like this: 
    tinymce.init({
    selector: "textarea",
    plugins: "link table code save moxiemanager",
});

 That should really be it, next step would be to fine tune the config options.

Custom MoxieManager Location

If you wish to put MoxieManager in a different folder, or are running the CDN version of TinyMCE, you can use the external_plugins option in TinyMCE.

tinymce.init({
    ...
    external_plugins: {
        "moxiemanager": "/moxiemanager/plugin.min.js"
    }
});

The path in this case is the root of the website, for example, if MoxieManager where installed in c:/inetpub/wwwroot/moxiemanager and c:/inetpub/wwwroot is the root of the website.

Next step - configuration

After the installation, standalone or in tinymce, you probably want to change some config options.

The most important configuration option (config.php) is this:

$moxieManagerConfig['filesystem.rootpath'] = "";

Read more about this option here

This is where your files are listed from, this can be an absolute or relative Path from the MoxieManager folder.

Absolute: /var/htdocs/mydomain/html

Relative: ../../../documents

Please note that if you are using symlinks/aliases/virtual directories, you might need additional configuration, but the rootpath should be set to the actuall path on server, not the path including the symlink/alias/virtual dir.

Add a name to your path:

MyName=../path/to/files

You probably want some form of authentication, check out the Authentication integration help. If you wish to turn off the authenticator, only recommended for testing or if you are behind basic authentication already, you simply set the $moxieManagerConfig["authenticator"] = ""; to an empty string.

Now, if you wish to configure plugins, you should check out the general.plugins option.

If you wish to use mc_access to set folder specific options, check out our how to.

And if you have problems, check out the FAQ of course!