[commits] [Wiki] changed: FAQ/Admin/Config

Wiki Guest wikiguest at horde.org
Fri Mar 4 23:10:48 UTC 2011


guest [76.122.146.81]  Fri, 04 Mar 2011 23:10:48 +0000

Modified page: http://wiki.horde.org/FAQ/Admin/Config
New Revision:  1.3
Change log:  Restore loosed '}' token to avoid empty page because of  
"Unbalanced token"

@@ -51,8 +51,9 @@
      'webroot' => '',
      'icon' => '/graphics/imp.gif',
      'name' => _("Mail"),
  </code>
+

  With the above settings, going to {{http://yourserver.example.com/}}  
will take the user right to the IMP login screen.

  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, and add an  
alias to make sure links into it still succeed. In Apache:
@@ -87,9 +88,8 @@

  <code type="php">
      'name' => _("Whatever"),
  </code>
-


  +++ How can I change the appearance?

@@ -104,9 +104,9 @@
  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/po/}}, 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/po/README}} file. For other  
components, follow the same steps using the  
{{/horde/componentname/po}} files.
+To change the translation for a locale, you must first change the  
locale files and then recompile them. Find the appropriate files in  
{{/horde/po/}}, 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/po/README}} file. For other  
components, follow the same steps using the {{/HordeComponentName/po}}  
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:

  <code>
@@ -120,9 +120,10 @@
  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  
{{[http://www.horde.org/horde/docs/?f=po_README.html  
horde/po/README]}} and  
{{[http://www.horde.org/horde/docs/?f=TRANSLATIONS.html  
horde/docs/TRANSLATIONS]}} for more information.
+Horde uses GNU gettext for internationalization (i18n) and  
localization (l10n). See  
{{[http://www.horde.org/horde/docs/?f=po_README.html horde/po/README]}}
+and {{[http://www.horde.org/horde/docs/?f=TRANSLATIONS.html  
horde/docs/TRANSLATIONS]}} for more information.

  +++ 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.
@@ -131,8 +132,9 @@

  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:
+

  <code>
  <VirtualHost ...>
  ...
@@ -147,25 +149,26 @@
    ...
  </VirtualHost>
  </code>

-Remember to test for module {{mod_php5.c} or similar if you are  
running PHP 5 or any other version.
+Remember to test for module {{mod_php5.c}} or similar if you are  
running PHP 5 or any other version.

  It has been reported that Horde, IMP, and Turba, with safe_mode  
enabled, are working fine with this apache configuration:

  <code>
-<Directory /path/to/horde>
-php_admin_value open_basedir  
"/path/to/horde:/path/to/pear/lib/:/path/to/logfile/dir"
-php_admin_flag file_uploads On
-php_admin_value upload_tmp_dir /path/to/horde/tmp
-<FilesMatch "smime\.php">
-php_admin_value safe_mode_exec_dir "/path/to/openssl/bin"
-php_admin_value open_basedir  
"/path/to/horde:/path/to/pear/lib/:/path/to/logfile/dir:/var/tmp"
-</FilesMatch>
-</Directory>
+	<Directory /path/to/horde>
+		php_admin_value open_basedir  
"/path/to/horde:/path/to/pear/lib/:/path/to/logfile/dir"
+		php_admin_flag file_uploads On
+		php_admin_value upload_tmp_dir /path/to/horde/tmp
+		<FilesMatch "smime\.php">
+			php_admin_value safe_mode_exec_dir "/path/to/openssl/bin"
+			php_admin_value open_basedir  
"/path/to/horde:/path/to/pear/lib/:/path/to/logfile/dir:/var/tmp"
+		</FilesMatch>
+	</Directory>
  </code>

-With this configuration, it is possible to import private keys, to  
sign and encrypt mails, to add attachment files, and to set languages.  
The {{$conf['tmpdir']}} setting must be set to {{/path/to/horde/tmp}}  
in the Horde setup. It is used for uploads (IMP attachments) and to  
generate temporary files when you are signing and/or encrypting mails.  
A special configuration is set for the {{smime.php}} file so it can  
run the openssl command to encrypt and decrypt the private key when it  
is imported in the database. To enable the private key import,  
{{/var/tmp}} must be added to the the {{open_basedir}} list (why?).
+With this configuration, it is possible to import private keys, to  
sign and encrypt mails, to add attachment files, and to set languages.
+The {{$conf['tmpdir']}} setting must be set to {{/path/to/horde/tmp}}  
in the Horde setup. It is used for uploads (IMP attachments) and to  
generate temporary files when you are signing and/or encrypting mails.  
A special configuration is set for the {{smime.php}} file so it can  
run the openssl command to encrypt and decrypt the private key when it  
is imported in the database. To enable the private key import,  
{{/var/tmp}} must be added to the the {{open_basedir}} list (why?).

  This configuration has been tested with a direct access to the SMTP  
server (no local sendmail).

  There is no warranty that everything works fine but the most  
important features (like sending, receiving, attaching files, signing,  
encrypting) are working fine.
@@ -233,8 +236,9 @@

  +++ How can I pre-configure a portal view for the users?

  You may have noticed within the Horde configuration an option to fix  
certain portal blocks on the Portal screen.  The next question is  
often "how are those blocks to be configured?"  The answer lies within  
the Horde Preferences system.  The Horde preference that controls the  
layout of the portal blocks and their settings is the 'portal_layout'  
preference.  This preference is stored as a serialized array of data  
containing all the information required to display the Portal.   
However this format can be tricky to come up with manually.  The  
easiest way to generate the value is to set up your own portal view as  
you would like your users to experience it.  Once you have done so,  
and saved the setting, the preference will be saved to your configured  
Horde_Prefs backend.  At this point you can either consult the  
Horde_Prefs backend directly (ie. pull the value directly from SQL or  
the Base64 encoded value from LDAP) or you can use Horde's built-in  
PHP Shell, accessible from the "Administration" menu.  To get your  
current preference value, type the following into the PHP Shell text  
box:
+

  <code>
  echo $GLOBALS['prefs']->getValue('portal_layout');
  </code>
@@ -383,4 +387,5 @@

  +++ How do I enable shared address books?

  **[Turba 2.1+]:** You can enable shared address book support for a  
source that supports this by adding {{'use_shares' => true}} to the  
source's stanza in {{horde/turba/config/sources.php}}. This allows  
users to create and delete new address books as well as manage  
permissions on the address books that they own. Permissions for shared  
address books should be set through the //My Address Books// interface  
in Turba and **not** through the administration interface. Choose the  
menu item //My Address Books// and then select the address book you  
want to share from the drop down menu in the //Edit Address Book//  
section then click //Edit Permissions//.
+



More information about the commits mailing list