.. contents:: Contents
.. section-numbering::
===========================
Horde Administrator's FAQ
===========================
-----------------------
General configuration
-----------------------
How can I have Horde in a different directory than /horde/ or configure an application to run in a virtual host?
================================================================================================================
There are usually two changes that people want to make as to how the URL to a Horde component appears in the browser. If only offering one component -- say, IMP -- then one often wants to have a url of http://webmail.example.com/ instead of http://webmail.example.com/horde/imp/.
If offering multiple Horde components -- say, IMP and Kronolith -- one often wants to have http://horde.example.com/mail/ and http://horde.example.com/calendar/ instead of the longer versions with the /horde/ component.
Virtual Host
************
To make a single Horde component appear at the root directory of the webserver, add aliases to your webserver's configuration file for the /horde/ directory, make the /horde/componentname/ the server's document root, and restart your web server.
For example, to make IMP appear at the root directory with Apache, add the following to the httpd.conf:
::
Alias /horde/ /usr/local/apache/htdocs/horde/
DocumentRoot /usr/local/apache/htdocs/horde/imp
(substituting your own directory names for the defaults above). Then, make sure links within Horde are correct as follows:
**[Horde 5]:**
Create or edit horde/config/registry.local.php (make sure the file starts with a PHP tag applications['horde']['webroot'] = '/horde';
$this->applications['imp']['webroot'] = '';
**[Horde 4]:**
Create or edit horde/config/registry.local.php (make sure the file starts with a PHP tag applications['imp']['webroot'] = '';
**[Horde 3]:**
Modify the $this->applications['imp'] array in horde/config/registry.php and change the value of the webroot as follows:
::
$this->applications['imp'] = array(
'fileroot' => dirname(__FILE__) . '/../imp',
'webroot' => '',
'icon' => '/graphics/imp.gif',
'name' => _("Mail"),
With the above settings, going to http://yourserver.example.com/ will take the user right to the IMP login screen.
Shorter/nicer URLs
******************
In the case where one wants to run more than one Horde component but omit the /horde/ part of the URL, configure the webserver to treat the /horde/ directory as the root document directory. In Apache:
::
DocumentRoot /usr/local/apache/htdocs/horde
(substituting directory names as appropriate). Then, if the automatic webroot detection doesn't work, make sure links within Horde are correct as follows:
**[Horde 4]:**
Create or edit horde/config/registry.local.php (make sure the file starts with a PHP tag applications['horde'] array in horde/config/registry.php and change the value of the webroot as follows:
::
$this->applications['horde'] = array(
'fileroot' => dirname(__FILE__) . '/..',
'webroot' => '',
'initial_page' => 'login.php',
'name' => _("Horde"),
If you want to change the name "Horde" on the login screen ("Welcome to Horde"), the above file is the place to do it.
**[Horde 4]:**
Create or edit horde/config/registry.local.php (make sure the file starts with a PHP tag applications['horde']['name'] = _("Whatever");
**[Horde 3]:**
Change the value from:
::
'name' => _("Horde"),
to
::
'name' => _("Whatever"),
How can I change the appearance?
================================
See `Doc/Dev/Layout`_ and Doc/Dev/Themes.
.. _`Doc/Dev/Layout`: https://wiki.horde.org/Doc/Dev/Layout?referrer=FAQ%2FAdmin%2FConfig
You can add Horde modules to the left navigation bar by creating/editing /horde/config/registry.local.php (Horde 4 or later) or modifying /horde/config/registry.php (Horde 3).
You can modify the components' navigation bars (at the top of screen) by adding menu entries through the Setup Interface, or modifying the /horde/componentname/config/menu.php files. Follow the instructions in the comments found in the file. This provides a very easy way to add links to the various Horde component navigation menus.
How can I change the phrases used for various features?
=======================================================
You may wish to alter some of the text in an existing language -- to match the terminology used locally, for instance.
You change strings by changing them in the locale files for the desired language(s). To change the US English translation, you will need to create a new US English (en_US) locale, as one normally does not exist, and modify the translations in that file. See the following FAQ entry for information on creating a new locale file.
To change the translation for a locale, you must first change the locale files and then recompile them. Find the appropriate files in /horde/locale/ (/horde/po/ in Horde 3), named by the locale name. Edit the translation(s) in this file to suite your needs. Then compile the locale files as described in your version's /horde/docs/TRANSLATIONS (/horde/po/README in Horde 3) file. For other components, follow the same steps using the /horde/componentname/locale/ files.
If you are having difficulty finding the file which contains the phrase you want to change, the following Unix command may be of assistance:
::
grep -rli 'Your Phrase' horde/
where horde/ is the root directory of your Horde installation. To make your search case sensitive remove the -i. To see the match rather than just the file name remove the -l.
Note: The following question may also be of help to you if you are changing the locale files.
How can I provide another translation for Horde/IMP's messages?
===============================================================
Horde uses GNU gettext for internationalization (i18n) and localization (l10n). See `horde/docs/TRANSLATIONS`_ for more information.
.. _`horde/docs/TRANSLATIONS`: http://www.horde.org/apps/horde/docs/TRANSLATIONS
How do I let users report problems directly from Horde?
=======================================================
Horde comes with a problem-reporting form. You can control who sees it, and what is done with problem reports, by going to the *Problem Reporting* tab of the Horde setup interface.
Can I use PHP's safe_mode with Horde?
=====================================
PHP's safe_mode is not officially supported by Horde, although we work around its restrictions wherever we can. Many have tried to use it, and have reported various levels of success. To run in safe_mode you will need to modify the PHP safe_mode settings. You may also have to change some code in Horde or other Horde components in order to make things work properly. Some of the known issues are not being able to set PHP maximum execution time, problems with spell checking, not being able to use Sendmail (without modifying the php safe_mode configuration), and problems with any sort of file uploads (adding attachments in IMP, file uploads in Gollem, etc).
If you run the Apache web server with virtual hosts and with PHP's safe_mode enabled by default, you can use the Apache PHP module configuration command php_admin_value in your main Apache configuration file to remove safe_mode for the Horde virtual host. For example:
::