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: http://www.cyberciti.biz/faq/how-do-i-add-jobs-to-cron-under-linux-or-unix-oses/
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 done
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.
Discussion
PLEASE NOTE: Comments to the wiki should only contain suggestions and questions that help us to improve the manual (and not the software). These comments will be deleted as soon as the information has been integrated into the manual.
Posts that do not contribute to the DOCUMENTATION of the project will be DELETED.
Ask QUESTIONS on the product here.
Report BUGS here.
Propose NEW FEATURES here.
beware , dont recomment setting up the cron every 1 min . . . checking emails every one min could get you banned from many mail services like gmail.
for crontab i would recommend 10 mins :
*/10 * * * * wget -O - -q -t 1 http://youopen.goo/cron.php
Actually, that is how often the script is invoked. You can separately configure how often email is checked by going to Administration / Cron Events.
When using self signed certificates (we only allow SSL opengoo connections) remember to use - -no-check-certificate (man wget).
*/10 * * * * wget - -no-check-certificate -O - -q -t 2 https://www.your_server_here.com/opengoo/cron.php
I have it try twice (just in case) and it runs on a remote machine.
Best Regards, cluge
By the way, this forum comment shows how to get opengoo/fengoffice working with SSL.
I ended up just editing config.php and setting ROOT_URL to one starting with 'https:'. That seems to just force all sessions to use https.
If you work in a shared hosting and your supplier doesn't offer the cron service, or you simply don't know anything about “wget” or whatever…
Just search the Web using the following key words:
Not the ideal solution, but maybe a suitable one for some working scenarios.
Using curl is a good option:
1.- Create cron_fengoffice file
2.- Include these lines:
# /etc/crontab: system-wide crontab # Unlike any other crontab you don't have to run the `crontab' # command to install the new version when you edit this file # and files in /etc/cron.d. These files also have username fields, # that none of the other crontabs do.
SHELL=/bin/sh PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
# m h dom mon dow user command * * * * * root /usr/bin/curl http://www.mydomain.ext/fengoffice/cron.php >/dev/null 2>&1
3. Copy this file to /etc/cron.d directory (root user o sudo command requiered)
4. That's all