| commit | author | age | ||
| bc1ec6 | 1 | Roundcube Framework |
| TB | 2 | =================== |
| 3 | ||
| 4 | INTRODUCTION | |
| 5 | ------------ | |
| 6 | The Roundcube Framework is the basic library used for the Roundcube Webmail | |
| 7 | application. It is an extract of classes providing the core functionality for | |
| 8 | an email system. They can be used individually or as package for the following | |
| 9 | tasks: | |
| 10 | ||
| 11 | - IMAP mailbox access with optional caching | |
| 12 | - MIME message handling | |
| 13 | - Email message creation and sending through SMTP | |
| 14 | - General caching utilities using the local database | |
| 15 | - Database abstraction using PDO | |
| 16 | - VCard parsing and writing | |
| 17 | ||
| 18 | ||
| 19 | INSTALLATION | |
| 20 | ------------ | |
| 21 | Copy all files of this directory to your project or install it in the default | |
| 22 | include_path directory of your webserver. Some classes of the framework require | |
| 23 | one or multiple of the following [PEAR][pear] libraries: | |
| 24 | ||
| 25 | - Mail_Mime 1.8.1 or newer | |
| 26 | - Net_SMTP (latest from https://github.com/pear/Net_SMTP/) | |
| 27 | - Net_IDNA2 0.1.1 or newer | |
| 28 | - Auth_SASL 1.0.6 or newer | |
| 29 | ||
| 30 | ||
| 31 | USAGE | |
| 32 | ----- | |
| 33 | The Roundcube Framework provides a bootstrapping file which registers an | |
| 34 | autoloader and sets up the environment necessary for the Roundcube classes. | |
| 35 | In order to make use of the framework, simply include the bootstrap.php file | |
| 36 | from this directory in your application and start using the classes by simply | |
| 37 | instantiating them. | |
| 38 | ||
| 39 | If you wanna use more complex functionality like IMAP access with database | |
| 40 | caching or plugins, the rcube singleton helps you loading the necessary files: | |
| 41 | ||
| d414cc | 42 | ```php |
| bc1ec6 | 43 | <?php |
| TB | 44 | |
| 45 | define('RCUBE_CONFIG_DIR', '<path-to-config-directory>'); | |
| 46 | define('RCUBE_PLUGINS_DIR', '<path-to-roundcube-plugins-directory'); | |
| 47 | ||
| 48 | require_once '<path-to-roundcube-framework/bootstrap.php'; | |
| 49 | ||
| 50 | $rcube = rcube::get_instance(rcube::INIT_WITH_DB | rcube::INIT_WITH_PLUGINS); | |
| 51 | $imap = $rcube->get_storage(); | |
| 52 | ||
| 53 | // do cool stuff here... | |
| 54 | ||
| 55 | ?> | |
| d414cc | 56 | ``` |
| bc1ec6 | 57 | |
| TB | 58 | LICENSE |
| 59 | ------- | |
| 60 | This program is free software: you can redistribute it and/or modify | |
| 61 | it under the terms of the GNU General Public License (**with exceptions | |
| 62 | for plugins**) as published by the Free Software Foundation, either | |
| 63 | version 3 of the License, or (at your option) any later version. | |
| 64 | ||
| 65 | This program is distributed in the hope that it will be useful, | |
| 66 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
| 67 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
| 68 | GNU General Public License for more details. | |
| 69 | ||
| 70 | You should have received a copy of the GNU General Public License | |
| 71 | along with this program. If not, see [www.gnu.org/licenses/][gpl]. | |
| 72 | ||
| 73 | This file forms part of the Roundcube Webmail Framework for which the | |
| 74 | following exception is added: Plugins which merely make function calls to the | |
| 75 | Roundcube Webmail Framework, and for that purpose include it by reference | |
| 76 | shall not be considered modifications of the software. | |
| 77 | ||
| 78 | If you wish to use this file in another project or create a modified | |
| 79 | version that will not be part of the Roundcube Webmail Framework, you | |
| 80 | may remove the exception above and use this source code under the | |
| 81 | original version of the license. | |
| 82 | ||
| 83 | For more details about licensing and the exceptions for skins and plugins | |
| 84 | see [roundcube.net/license][license] | |
| 85 | ||
| 86 | ||
| 87 | CONTACT | |
| 88 | ------- | |
| 89 | For any bug reports or feature requests please refer to the tracking system | |
| 90 | at [trac.roundcube.net][tracreport] or subscribe to our mailing list. | |
| 91 | See [roundcube.net/support][support] for details. | |
| 92 | ||
| 93 | You're always welcome to send a message to the project admins: | |
| 94 | hello(at)roundcube(dot)net | |
| 95 | ||
| 96 | ||
| 97 | [pear]: http://pear.php.net | |
| 98 | [gpl]: http://www.gnu.org/licenses/ | |
| 99 | [license]: http://roundcube.net/license | |
| 100 | [support]: http://roundcube.net/support | |
| 101 | [tracreport]: http://trac.roundcube.net/wiki/Howto_ReportIssues | |
