Table of Contents

如何设置Feng Office

This page is a tutorial about how to set up Feng Office quickly right after the installation process.

Even if every use of Feng Office is different, there are some aspects which are often the same. Preparing your Feng Office installation for your users is important for the acceptance of the system, for the ease of use, for the efficiency of your collaboration, for the success of your project. So why not spend some minutes to go through this tutorial and to see whether there are some recommendations that might be valuable for you as well.

This tutorial is much like a checklist: We give explanations what to do, but not how to do it (we simply refer to the other parts of this wiki if you should need more information).


Feng Office supports your first steps with the getting started widget on the dashboard. However, it's recommended that you read this wiki page anyway since it contains important information that is not provided in the widget.


The very first step is rather technical. But don't worry: It's just a matter of choosing an option in a dropdown menu, and if you are not sure which one too choose you can even leave things as they are.

What to do:

How to do it:


To begin, check your own user account by clicking on “Account” in the upper right corner. This account has been created by the installer, but right now there is not much information in it.

What to do:

How to do it:


Before doing anything else, create the companies that are involved. Users, contacts, workspaces - they all relate to companies, so it's a good practice to start here.

What to do:

How to do it:


All information in Feng Office is organized in workspaces, so you have to create them early. Since you can organize workspaces in hierarchical structures, it's worth the time to think about an ideal structure before building it. Keep in mind that workspaces are more than just folders because there are permissions attached to them.

What to do:

How to do it:


There are not too many system configuration settings in Feng Office, and some of them may even not matter to you. But it's a good idea to check them now, not later.

What to do:

How to do it:


Now it's time to open your Feng Office installation to other people by creating users.

What to do:

How to do it:


There are some tasks that Feng Office can perform asynchronously (on the background) without the need of user interaction, like fetching new emails, or sending notifications. This can greatly improve usability, as for example, the user doesn't need to wait while Feng Office fetches new emails, the new emails will already be waiting for him on Feng Office. An Administrator user can configure how often this tasks are performed, by going to Administration panel → Cron Events.

But in order for this to work you need to tell your server to periodically run a script in Feng Office. This script is “cron.php”, on Feng Office's root folder. This script can be executed either by being accessed via web or by executing it with the PHP command line client. However you make the server to periodically execute this script is not important, but the common way to achieve this is by defining a cron job that every minute executes:

  wget -O - -q http://localhost/feng/cron.php

If you don't have wget or a similar tool you can use the PHP command line interpreter to execute cron.php. Make sure that the user that calls this script is the same as the web server's user, so that you avoid permissions problems (you can do this by making the cron job be ran by that user or by using sudo -u <user> before the command):

  php /path/to/feng/cron.php

You can save the output in a file by redirecting the output to a file:

  wget -O - -q http://localhost/feng/cron.php >> cron_log.txt 2>&1

If using wget through https and your server uses a self signed certificate add the option - -no-check-certificate.

Here you can see instructions on how to configure a cron job on linux/unix:

If you have no way of configuring a cron job, other ways of achieving the same effect could be:

      while [ 1 = 1 ]; do
        php /path/to/feng/cron.php
        sleep 60  # sleep for a minute


You can improve the initial loading time of Feng Office by following these instructions. Every Feng Office release comes with the full readable Javascript and CSS, but it also includes minified versions that are much smaller (and thus load faster). To use these instead of the uncompressed version you have to add two constants in the config/config.php file, like this:

    define('COMPRESSED_CSS', true);
    define('COMPRESSED_JS', true);

This will tell Feng Office to use the compressed versions of the code instead of the full version. Note: If you make any modifications to the Javascript and/or CSS these won't be reflected in the minified code automatically. You can minify the new code by accessing http:/ /(feng root)/public/tools and choosing to “Minify CSS and Javascript”.

Another config option you can try, though could not work in all cases, is this one:

    define('USE_JS_CACHE', true);

This will compress the initial Javascript before sending it to the server. It can further improve the loading time.

1) We need some information about the pros and cons of each option here.