[cvs] [Wiki] changed: FAQ/Admin/Config
Jan Schneider
jan at horde.org
Sun May 22 04:44:40 PDT 2005
jan Sun, 22 May 2005 04:44:40 -0700
Modified page: http://wiki.horde.org/display.php?page=FAQ%2FAdmin%2FConfig
New Revision: 1.3
@@ -267,4 +267,247 @@
* If using the sql backend with the {{horde_users}} table, the password must be in md5() format (and not the !MySQL password() format, for example).
* CVS HEAD versions provide a script {{horde/scripts/db/auth_initial_user.sql}} which will create an initial admin user for sql authentication. This can be used to login and configure the system. If you use this, be sure to change it as soon as possible so it does not become a security risk.
* If using IMAP authentication, see the comments in {{horde/imp/config/servers.php}} for options you may need to specify.
++++ IMP configuration
+
+++++ Can a single IMP installation serve different virtual hosts?
+If you have your webserver set up to answer requests from multiple domains, you can use those virtual hosts to ensure that mail is sent with the appropriate From: header. In other words, when someone goes to
+
+<code>
+http://example.com/webmail/
+</code>
+
+mail will be sent from //username at example.com//, and when they go to
+
+<code>
+http://example.net/webmail/
+</code>
+
+mail will be sent from //username at example.net//.
+
+**[IMP 2.2]:** To do this, set the following values in {{/horde/imp/config/defaults.php3}}:
+
+<code type="php">
+$default->server = $SERVER_NAME;
+$default->from_server = $SERVER_NAME;
+</code>
+
+Note that the above will allow someone to go to a different virtual host than the one they are intended to use, after which their mail will come from the unintended virtual host.
+
+**[IMP 3.x]:** It is possible in Horde 2.x and IMP 3.x to use virtual hosts, but at this time we have no instructions for doing so. You can check the IMP mailing list archives for information.
+
+++++ How can I restrict what my users can do with IMP?
+**[IMP 2.2]:** There are a number of IMP features and functions which can be disabled in imp's configuration file, {{/horde/imp/config/defaults.php3}}.
+
+They are:
+
+* Disable New User introduction
+
+<code type="php">
+$default->newuser_link = false;
+</code>
+
+* Use fewer new browser windows
+
+<code type="php">
+$default->minimum_popups = true;
+</code>
+
+* Do not allow user to choose IMAP server
+
+<code type="php">
+$default->user_change_server = false;
+</code>
+
+* Only allow user to choose from servers listed in /horde/imp/config/servers.php3
+
+<code type="php">
+$default->use_server_list = true;
+</code>
+
+* Do not allow user to choose IMAP port
+
+<code type="php">
+$default->user_change_port = false;
+</code>
+
+* Do not allow user to choose between POP3 and IMAP
+
+<code type="php">
+$default->user_change_servtype = false;
+</code>
+
+* Do not allow user to use mail folders other than INBOX
+
+<code type="php">
+$default->user_use_folders = false;
+</code>
+
+* Do not allow user to specify folder directory at login
+
+<code type="php">
+$default->user_change_folder = false;
+</code>
+
+* Do not allow user to subscribe/unsubscribe IMAP folders (i.e., use all folders present)
+
+<code type="php">
+$default->use_imap_subscribe = false;
+</code>
+
+* Disable UW-IMAP's #shared, #public and #news hierarchy:
+
+<code type="php">
+$default->show_shared_hierarchy = false;
+$default->show_public_hierarchy = false;
+$default->show_news_hierarchy = false;
+</code>
+
+* Refrain from saving copies of outgoing mail
+
+<code type="php">
+$default->save_sent_mail = false;
+</code>
+
+* Disable "You have new mail" popup window
+
+<code type="php">
+$default->newmail_popup = false;
+</code>
+
+* Do not allow user to select language
+
+<code type="php">
+$default->user_change_language = false
+</code>
+
+* Do not allow user to change their From: header or their full name
+
+<code type="php">
+$default->user_change_from = false;
+$default->user_change_fullname = false;
+</code>
+
+* Disable address book feature
+
+<code type="php">
+$default->user_use_addressbook = false;
+</code>
+
+**[IMP 3.x]:** IMP 3.x contains similar functionality in the files {{horde/imp/config/conf.php}} and {{/horde/imp/config/prefs.php}}. See the comments in those files for more information.
+
+When changing settings in {{/horde/imp/config/prefs.php}} you can set the "value" field for a preference to set the default value of that preference. If you want to force users to use that value, and not allow them to change it, you must also set the "locked" field to //true//.
+
+++++ How can I configure IMP's maximum attachment size?
+By default, PHP limits uploaded files to 2 MB, and this limit applies to attachments on messages sent from IMP. To change this value, edit the following value in your {{php.ini}} (or, in PHP3, {{php3.ini}}):
+
+<code>
+upload_max_filesize = number of bytes
+</code>
+
+You will need to restart your web server after this change.
+
+++++ Can I add a custom header to mail sent from IMP?
+To add custom SMTP headers to mail sent from IMP, place the headers in {{/horde/imp/config/header.txt}}. Make sure that your header is the last line in the file! You can include PHP variables by enclosing them in percent signs ("%"). One useful header is
+
+<code>
+X-Originating-IP: %REMOTE_ADDR%
+</code>
+
+which follows a de-facto standard adhered to by Hotmail, Yahoo Mail, and Dejanews (to name but a few) of listing the address of the computer at which the mail message was composed.
+
+Note that these are //email headers//, not body text. If you want to add an advertisement for your webmail service, or a similar announcement, to outgoing mail, put it at the bottom of the message (which is the standard location) by placing the text in {{/horde/imp/config/tailer.txt}}.
+
+++++ Where can I find foreign-language dictionaries for spellcheck?
+Oxford University's archive provides [ftp://sable.ox.ac.uk/pub/wordlists wordlists] for the languages in IMP's spellcheck (and many more!), as does the [http://ficus-www.cs.ucla.edu/ficus-members/geoff/ispell-dictionaries.html International ispell Home Page].
+
+++++ How do I access shared mail folders? Maildir folders? MH folders?
+All of the above are transparent to the IMAP protocol itself, and are thus transparent to IMP. If you can tell your IMAP server to serve the type of folders that you want to serve, then IMP can read them.
+
+Both Maildir and shared folders are supported by [http://www.inter7.com/courierimap/ Courier-IMAP], although it does not support standard mbox format mailboxes. MH folders are supported by [http://www.washington.edu/imap/ UW-IMAP].
+
+Note that you can not use folders with POP3 as the POP3 protocol does not contain any support for folders. If you want to use folders then you must configure IMP to use IMAP rather than POP3 access.
+
+++++ Can IMP show attachments or html inline?
+IMP is //capable// of showing certain attachments inline (i.e., in the message body, rather than appearing in a new window on request), but in some cases it risks exposing the user to a security problem in the browser: by enabling inline HTML, any javascript (!ActiveX, Java, etc.) in the attachment will be executed by the browser. //Enabling inline HTML attachments is strongly discouraged//.
+
+Of course, this will only work for elements that could be part of a regular HTML page. In particular, images //cannot// be part of in a regular HTML page (they have to be a separate file with an <IMG> tag to include them in an HTML page), and can thus not be inlined.
+
+**[IMP 2.2]:** Before any attachments will appear inline, inline display must be turned on globally in {{/horde/imp/config/defaults.php3}} by setting one or both of the following variables (depending on IMP version) as shown:
+
+<code type="php">
+$default->inline_in_parts_list = false;
+$default->text_parts_inline = true;
+</code>
+
+After this, for each MIME type you wish to have displayed inline, modify the entry in {{/horde/imp/config/mime.php3}}:
+
+<code type="php">
+'inline' => true,
+</code>
+
+Note that some mime types (like text/html) may have multiple entries in the {{mime.php3}} file. Pick the one(s) that meet your needs.
+
+**[IMP 3.x]:** Edit the file {{horde/imp/config/mime_drivers.php}} to enable inline support for the mime types you wish to have displayed inline. Simply set the 'inline' array element for that mime type to 'true' to enable a type. As noted above, not all mime types can be shown inline; if there is no 'inline' array element for a mime type than that type can not be viewed inline.
+
+For example, to enable inline html support you would set:
+
+<code type="php">
+$mime_drivers['imp']['html']['inline'] = true;
+</code>
+
+++++ How can I use LDAP for IMP's contact list?
+For LDAP searches to work in IMP, LDAP support must have been compiled into PHP.
+
+**[IMP 2.2]:** To configure IMP to allow LDAP searches in the contact list, first enable LDAP in {{/horde/imp/config/defaults.php3}}:
+
+<code type="php">
+$default->use_ldap_search = true;
+</code>
+
+Then, in {{/horde/imp/config/ldap.php3}}, specify your LDAP servers. An example LDAP server configuration is available in {{/horde/imp/config/ldap.php3.dist}}.
+
+**[IMP 3.x]:** IMP 3.x no longer has a built-in address book, but instead uses the Horde module Turba for an address book. See the Turba faq section for information on configuring Turba for LDAP support. You must have Turba installed and working before you configure IMP to use it for address books.
+
+To configure IMP to use one or more Turba directories, you modify the file {{horde/imp/config/prefs.php}} to set the value of the {{$_prefs['search_sources']}} array. The 'value' field of this array needs to be set to a tab delimited set of Turba directory sources. IMP will then use these sources for directory lookups.
+
+++++ How can I let users change their password through IMP?
+**[IMP 2.2]:** To enable password changes through IMP, set the following in {{/horde/imp/config/defaults.php3}}:
+
+<code type="php">
+$default->change_password = 'poppassd.php3';
+$default->poppassd_server = $SERVER_NAME;
+$default->poppassd_port = '0';
+</code>
+
+You will have to install a [http://www.netwinsite.com/poppassd/ poppassd server] on your IMAP server for the above to work. Note that that poppassd won't work out of the box unless you're using !SunOS from 1993; you'll have to tell it what to expect from your passwd command at the top of {{poppassd.c}}.
+
+If you're using a recent version of Linux that authenticates via PAM, Jacob Coreil observes that a modified and [ftp://ftp.ceti.com.pl/pub/linux/poppassd-1.8-ceti.tar.gz PAM-ready version of poppassd] is also available.
+
+You can also set
+
+<code type="php">
+$default->change_password
+</code>
+
+to the URL of a dedicated password-changing program at your site, or you can change
+
+<code type="php">
+$default->poppassd_server
+</code>
+
+to point to a central password server at your site which runs poppassd.
+
+**[IMP 3.x]:** IMP 3.x does not include support for changing passwords. You can download a seperate Horde module called //passwd// to add this functionality.
+
+++++ How can I let users open new accounts through IMP?
+**[IMP 2.2]:** There is rudimentary account-signup functionality built into Horde 1.2 (IMP 2.2), which will allow users to fill out a form to request an account, and then send the collected data to a specified email address. To enable it, set the following in {{horde/config/horde.php3}}:
+
+<code type="php">
+$default->signup = true;
+$default->signup_email = 'address which receives account requests';
+</code>
+
+There is currently no automated account creation facility in IMP. If you feel you are capable of writing this (meaning that you know how to write secure setuid programs!), look at {{horde/signup.php3}}. Keep in mind that allowing users to create accounts without any sort of admin authorization might not be a good thing.
+
+**[IMP 3.x]:** This functionality is not available in Horde 2.x or IMP 3.x at this time.
More information about the cvs
mailing list