Setup - backend - Unix/Linux Servers

The following instructions explain how to set up the fCMS on a Unix/Linux webserver. For IIS webservers, please click here. If you are upgrading the backend files from a previous version, please ensure that you have read the what's new section for any important upgrade information.

The webserver on which your fCMS is hosted must meet the following requirements:

- Apache webserver allowing .htaccess override (for IIS webservers, please click here).
- PHP 4.3+

1. Uploading the files to your webserver

3. Moving the content to another webserver

4. Security settings for local testing of fCMS

5. Setting up users

6. Setting up user groups and file upload permissions

1. Before uploading you may want to open and edit the users.xml and config.xml files to edit the users and permissions.
2. Upload the entire fCMSBackend folder from your hard drive to your webserver.
3. Use your FTP application to change permissions (CHMOD) of the fCMSBackend/imgRoot folder to 777 (this is necessary for uploading the image files).
4. Use your FTP application to change permissions (CHMOD) of fCMSBackend/xmlContent.xml file to 777 (this is where the content is stored).

This will work when testing in the Flash authoring environment. You will also need to copy the modules folder from the fCMSBackend folder into the same folder where your .fla file is located. When testing in a browser, always upload your files to the web server first. In this case the paths can be relative.

First you must locate the file called users.xml which is in the "fCMSBackend/config" folder. Once you have located this file, you may edit is using any text editor (for example, Notepad or Wordpad for Windows users or TextEdit for Mac users).

The default users.xml file looks like this:

<?xml version="1.0" encoding="utf-8"?>
  <groups>
    <group name="admin">
      <users>
        <user name="admin" password="admin"/>
      </users>
    </group>
    <group name="group2">
      <users>
        <user name="user1" password="user1"/>
        <user name="user2" password="user2"/>
      </users> 
    </group>
</groups>

You can change the administrator's username and password by editing these values which are highlighted in magenta in the XML file above. The username and password for user1 and user2 are highlighted in blue.

To add or remove users and usergroups, simply add or remove XML nodes, keeping the exact same formatting. For example, to add a new user to "group2" add a new node to the users tag of "group2". The example below shows a new user added with username "iUser" and password "iPass":

<?xml version="1.0" encoding="utf-8"?>
  <groups>
    <group name="admin">
      <users>
        <user name="admin" password="admin"/>
      </users>
    </group>
    <group name="group2">
      <users>
        <user name="user1" password="user1"/>
        <user name="user2" password="user2"/>
        <user name="iUser" password="iPass"/>
      </users> 
    </group>
</groups>

1. Locate the file called config.xml which is in the "fCMSBackend/config" folder. Once you have located this file, you may edit is using any text editor (for example, Notepad or Wordpad for Windows users or TextEdit for Mac users).

2. You may edit the highlighted values below in order to change the accepted file upload types and the maximum permitted file upload size (in bytes). We recommend setting the maximum file upload size to around 100kb (102400 bytes):

<extensions>jpg,gif,png,swf</extensions>
<maxsize>1048576</maxsize>

Note: Your php.ini file may be set to allow a maximum file upload of 2MB (2097152 bytes).

3. The code below shows the group permission settings for the admin and group2 user groups. You may edit these settings, delete group2 or create your own addition groups underneath group2, as shown in blue below:

<group name="admin">
  <filebrowser>
    <root>/</root>
    <upload>true</upload>
    <delete>true</delete>
    <preview>true</preview>
  </filebrowser>
  <fcms>
		<edit>true</edit>
  </fcms>
</group>
<group name="group2">
  <filebrowser>
    <root>myFolder/</root>
    <upload>true</upload>
    <delete>false</delete>
    <preview>true</preview>
  </filebrowser>
  <fcms>
		<edit>true</edit>
  </fcms>
</group>
<group name="limitedusers">
  <filebrowser>
    <root>myFolder/</root>
    <upload>false</upload>
    <delete>false</delete>
    <preview>true</preview>
  </filebrowser>
  <fcms>
		<edit>true</edit>
  </fcms> 
</group> 

You can configure the FileBrowser differently for each user group:

• root - this defines the path of the directory on the server which is accessible to the user. If the value is "/" users belonging to that group would be able to access all of the directories inside the root directory which is defined in the global settings of the config.xml. The default global root directory is imgRoot so the "/" value will mean that users are able to access all of the directories inside the fCMSBackend/imgRoot directory.
• upload - can be true or false. If the value is true users will be able to upload files and create directories inside their group root folder
• delete - can be true or false. If the value is true users will be able to delete files and directories inside their group root folder
• preview - can be true or false. If the value is true users will be able to see a preview of images inside their group root folder

In the example above, users belonging to group2 can only access the directory named myFolder and are able to upload files and create directories inside it. They can preview images stored in the backend inside the fCMS. The directory myFolder is inside the root directory defined in config/global/root.