\documentclass{article}
\usepackage{ulem}
\pagestyle{headings}
\begin{document}
\tableofcontents
Horde Administrator's FAQGeneral configurationHow can I have Horde in a different directory than /horde/ or configure an application to run in a virtual host?Virtual HostShorter/nicer URLsHow can I change the appearance?How can I change the phrases used for various features?How can I provide another translation for Horde/IMP's messages?How do I let users report problems directly from Horde?Can I use PHP's safe\_mode with Horde?How can I add a graphic or banner to every page?Why do old preference values overrule newly locked preference values?How do I deactivate the username/password saving feature at the login screen?I've just installed Horde, how do I log in or create users?What are the default user name and password for the administrator?How can I get back to the setup screen?How can I pre-configure a portal view for the users?IMP configurationCan a single IMP installation serve different virtual hosts?How can I restrict what my users can do with IMP?How can I configure IMP's maximum attachment size?Can I add a custom header to mail sent from IMP?How do I access shared mail folders? Maildir folders? MH folders?Can IMP show attachments or html inline?How can I use LDAP for IMP's contact list?How can I let users change their password through IMP?How can I let users open new accounts through IMP?How can I remove maintenance functions in IMP?Why doesn't the Options button show up in IMP?Can IMP be used with SMTP authentication?How can I remove or change the text appended to each email sent through IMP?Turba ConfigurationHow can I use LDAP for IMP's contact list?How do I enable shared address books?
\part{Horde Administrator's FAQ}
\section{General configuration}
\subsection{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/\footnote{http://webmail.example.com/} instead of http://webmail.example.com/horde/imp/\footnote{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/\footnote{http://horde.example.com/mail/} and http://horde.example.com/calendar/\footnote{http://horde.example.com/calendar/} instead of the longer versions with the \texttt{/horde/} component.
\subsubsection{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 \texttt{/horde/} directory, make the \texttt{/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 \texttt{httpd.conf}:
\begin{verbatim}
Alias /horde/ /usr/local/apache/htdocs/horde/
DocumentRoot /usr/local/apache/htdocs/horde/imp
\end{verbatim}
(substituting your own directory names for the defaults above). Then, make sure links within Horde are correct as follows:
\textbf{[Horde 5]:}
Create or edit \texttt{horde/config/registry.local.php} (make sure the file starts with a PHP tag \texttt{applications['horde']['webroot'] = '/horde';
$this->applications['imp']['webroot'] = '';
\end{verbatim}
\textbf{[Horde 4]:}
Create or edit \texttt{horde/config/registry.local.php} (make sure the file starts with a PHP tag \texttt{applications['imp']['webroot'] = '';
\end{verbatim}
\textbf{[Horde 3]:}
Modify the \texttt{\$this->applications['imp']} array in \texttt{horde/config/registry.php} and change the value of the webroot as follows:
\begin{verbatim}
$this->applications['imp'] = array(
'fileroot' => dirname(__FILE__) . '/../imp',
'webroot' => '',
'icon' => '/graphics/imp.gif',
'name' => _("Mail"),
\end{verbatim}
With the above settings, going to \texttt{http://yourserver.example.com/\footnote{http://yourserver.example.com/}} will take the user right to the IMP login screen.
\subsubsection{Shorter/nicer URLs}
In the case where one wants to run more than one Horde component but omit the \texttt{/horde/} part of the URL, configure the webserver to treat the \texttt{/horde/} directory as the root document directory. In Apache:
\begin{verbatim}
DocumentRoot /usr/local/apache/htdocs/horde
\end{verbatim}
(substituting directory names as appropriate). Then, if the automatic webroot detection doesn't work, make sure links within Horde are correct as follows:
\textbf{[Horde 4]:}
Create or edit \texttt{horde/config/registry.local.php} (make sure the file starts with a PHP tag \texttt{applications['horde']} array in \texttt{horde/config/registry.php} and change the value of the webroot as follows:
\begin{verbatim}
$this->applications['horde'] = array(
'fileroot' => dirname(__FILE__) . '/..',
'webroot' => '',
'initial_page' => 'login.php',
'name' => _("Horde"),
\end{verbatim}
If you want to change the name "Horde" on the login screen ("Welcome to Horde"), the above file is the place to do it.
\textbf{[Horde 4]:}
Create or edit \texttt{horde/config/registry.local.php} (make sure the file starts with a PHP tag \texttt{applications['horde']['name'] = _("Whatever");
\end{verbatim}
\textbf{[Horde 3]:}
Change the value from:
\begin{verbatim}
'name' => _("Horde"),
\end{verbatim}
to
\begin{verbatim}
'name' => _("Whatever"),
\end{verbatim}
\subsection{How can I change the appearance?}
See Doc/Dev/Layout\footnote{http://example.com/index.php?page=Doc/Dev/Layout} and Doc/Dev/Themes.
You can add Horde modules to the left navigation bar by creating/editing \texttt{/horde/config/registry.local.php} (Horde 4 or later) or modifying \texttt{/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 \texttt{/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.
\subsection{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 \texttt{/horde/locale/} (\texttt{/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 \texttt{/horde/docs/TRANSLATIONS} (\texttt{/horde/po/README} in Horde 3) file. For other components, follow the same steps using the \texttt{/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:
\begin{verbatim}
grep -rli 'Your Phrase' horde/
\end{verbatim}
where \texttt{horde/} is the root directory of your Horde installation. To make your search case sensitive remove the \texttt{-i}. To see the match rather than just the file name remove the \texttt{-l}.
Note: The following question may also be of help to you if you are changing the locale files.
\subsection{How can I provide another translation for Horde/IMP's messages?}
Horde uses GNU gettext for internationalization (i18n) and localization (l10n). See \texttt{horde/docs/TRANSLATIONS\footnote{http://www.horde.org/apps/horde/docs/TRANSLATIONS}} for more information.
\subsection{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 \textsl{Problem Reporting} tab of the Horde setup interface.
\subsection{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 \texttt{php\_admin\_value} in your main Apache configuration file to remove safe\_mode for the Horde virtual host. For example:
\begin{verbatim}