X-Git-Url: https://git.cweiske.de/bdrem.git/blobdiff_plain/ef83af1b350cd1d1c8bf28077977763bdae93cf2..83afda94b7d5fc2be341712e2661f6095f608e0d:/README.rst diff --git a/README.rst b/README.rst index 42af37f..8db33cd 100644 --- a/README.rst +++ b/README.rst @@ -1,12 +1,27 @@ ********************************* bdrem - Birthday reminder by mail ********************************* -Birthday reminder that sends out mails (Text and HTML). +Birthday reminder that sends out e-mails. -It can also generate tables on your console/shell output and -normal HTML pages. +It can also generate ASCII tables on your console/shell and normal HTML pages. +======== +Features +======== + +Data sources +============ +- Any SQL database +- An LDAP server +- Birthday reminder files (``.bdf``) + +Output formats +============== +- ASCII table +- HTML +- Email (text + HTML parts) + ============= Configuration @@ -17,15 +32,16 @@ adjust it to your liking. MS SQL server ============= -Configure the date format in ``/etc/freedts/locales.conf``:: +Configure the date format in ``/etc/freetds/locales.conf``:: [default] date format = %Y-%m-%d -Also set the charset to UTF-8 in ``/etc/freedts/freedts.conf``:: +Also set the charset to UTF-8 in ``/etc/freetds/freetds.conf``:: [global] - # TDS protocol version tds version = 8.0 + # TDS protocol version + tds version = 8.0 client charset = UTF-8 Restart Apache afterwards. @@ -33,3 +49,31 @@ Restart Apache afterwards. Use ``dblib`` in the DSN:: dblib:host=192.168.1.1;dbname=Databasename + + +============ +Dependencies +============ +- PHP 5.3 or higher +- PDO +- PEAR packages: + + - Console_CommandLine + - Mail + - Mail_mime + - Console_Table + - Net_LDAP2 + + +======= +License +======= +``bdrem`` is licensed under the `AGPL v3`__ or later. + +__ http://www.gnu.org/licenses/agpl.html + + +====== +Author +====== +Written by Christian Weiske, cweiske@cweiske.de