From 6dfd5b1fac9e0cead6cde5966146f6580733c018 Mon Sep 17 00:00:00 2001 From: cla Date: Thu, 22 Jan 2015 14:15:34 +0100 Subject: [PATCH 1/5] Added extrafields features for Supplier Invoice Line and Supplier Order Line --- htdocs/core/lib/fourn.lib.php | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/htdocs/core/lib/fourn.lib.php b/htdocs/core/lib/fourn.lib.php index e4e7b04b057..cf1db634e88 100644 --- a/htdocs/core/lib/fourn.lib.php +++ b/htdocs/core/lib/fourn.lib.php @@ -186,10 +186,22 @@ function supplierorder_admin_prepare_head() $head[$h][2] = 'supplierorder'; $h++; + $head[$h][0] = DOL_URL_ROOT.'/admin/supplierorderdet_extrafields.php'; + $head[$h][1] = $langs->trans("ExtraFieldsLines"); + $head[$h][2] = 'supplierorderdet'; + $h++; + + + $head[$h][0] = DOL_URL_ROOT.'/admin/supplierinvoice_extrafields.php'; $head[$h][1] = $langs->trans("ExtraFieldsSupplierInvoices"); $head[$h][2] = 'supplierinvoice'; $h++; + + $head[$h][0] = DOL_URL_ROOT.'/admin/supplierinvoicedet_extrafields.php'; + $head[$h][1] = $langs->trans("ExtraFieldsLines"); + $head[$h][2] = 'supplierinvoicedet'; + $h++; complete_head_from_modules($conf,$langs,null,$head,$h,'supplierorder_admin','remove'); From c953a04687bd17f2f51e47718117d144d7ff4edc Mon Sep 17 00:00:00 2001 From: cla Date: Thu, 22 Jan 2015 14:18:33 +0100 Subject: [PATCH 2/5] Added files for Extrafields in Order/Invoice Supplier Line. New files sql added in install/mysql folder and 2 new pages to insert extrafields in admin folder --- .../admin/supplierinvoicedet_extrafields.php | 162 ++++++++++++++++++ htdocs/admin/supplierorderdet_extrafields.php | 159 +++++++++++++++++ ...ommande_fournisseurdet_extrafields.key.sql | 19 ++ ...lx_commande_fournisseurdet_extrafields.sql | 30 ++++ .../llx_facture_fourndet_extrafields.key.sql | 20 +++ .../llx_facture_fourndet_extrafields.sql | 26 +++ 6 files changed, 416 insertions(+) create mode 100644 htdocs/admin/supplierinvoicedet_extrafields.php create mode 100644 htdocs/admin/supplierorderdet_extrafields.php create mode 100644 htdocs/install/mysql/tables/llx_commande_fournisseurdet_extrafields.key.sql create mode 100644 htdocs/install/mysql/tables/llx_commande_fournisseurdet_extrafields.sql create mode 100644 htdocs/install/mysql/tables/llx_facture_fourndet_extrafields.key.sql create mode 100644 htdocs/install/mysql/tables/llx_facture_fourndet_extrafields.sql diff --git a/htdocs/admin/supplierinvoicedet_extrafields.php b/htdocs/admin/supplierinvoicedet_extrafields.php new file mode 100644 index 00000000000..b8525601a61 --- /dev/null +++ b/htdocs/admin/supplierinvoicedet_extrafields.php @@ -0,0 +1,162 @@ + + * Copyright (C) 2003 Jean-Louis Bergamo + * Copyright (C) 2004-2013 Laurent Destailleur + * Copyright (C) 2012 Regis Houssin + * Copyright (C) 2012 Florian Henry + * Copyright (C) 2013 Philippe Grand + * Copyright (C) 2013 Juanjo Menent + * Copyright (C) 2015 Claudio Aschieri + * + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 3 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . + */ + +/** + * \file htdocs/admin/supplierinvoicedet_extrafields.php + * \ingroup fourn + * \brief Page to setup extra fields of supplierinvoice line + */ + +require '../main.inc.php'; +require_once DOL_DOCUMENT_ROOT.'/core/lib/fourn.lib.php'; +require_once DOL_DOCUMENT_ROOT.'/core/class/extrafields.class.php'; + + +if (!$user->admin) + accessforbidden(); + +$langs->load("admin"); +$langs->load("other"); +$langs->load("bills"); +$langs->load("orders"); +$langs->load("suppliers"); + +$extrafields = new ExtraFields($db); +$form = new Form($db); + +// List of supported format +$tmptype2label=ExtraFields::$type2label; +$type2label=array(''); +foreach ($tmptype2label as $key => $val) $type2label[$key]=$langs->trans($val); + +$action=GETPOST('action', 'alpha'); +$attrname=GETPOST('attrname', 'alpha'); +$elementtype='facture_fourndet'; //Must be the $table_element of the class that manage extrafield + +if (!$user->admin) accessforbidden(); + + +/* + * Actions + */ + +require DOL_DOCUMENT_ROOT.'/core/actions_extrafields.inc.php'; + + + +/* + * View + */ + +$textobject=$langs->transnoentitiesnoconv("BillsSuppliers"); + +llxHeader('',$langs->trans("SuppliersSetup")); + +$linkback=''.$langs->trans("BackToModuleList").''; +print_fiche_titre($langs->trans("SuppliersSetup"),$linkback,'setup'); +print "
\n"; + +$head = supplierorder_admin_prepare_head(); + +dol_fiche_head($head, 'supplierinvoicedet', $langs->trans("Suppliers"), 0, 'company'); + + +print $langs->trans("DefineHereComplementaryAttributes",$textobject).'
'."\n"; +print '
'; + +// Load attribute_label +$extrafields->fetch_name_optionals_label($elementtype); + +print ""; + +print ''; +print ''; +print ''; +print ''; +print ''; +print ''; +print ''; +print ''; +print "\n"; + +$var=True; +foreach($extrafields->attribute_type as $key => $value) +{ + $var=!$var; + print ""; + print "\n"; + print "\n"; + print "\n"; + print '\n"; + print '\n"; + print '\n"; + print '\n"; + print ""; +} + +print "
'.$langs->trans("Label").''.$langs->trans("AttributeCode").''.$langs->trans("Type").''.$langs->trans("Size").''.$langs->trans("Unique").''.$langs->trans("Required").' 
".$extrafields->attribute_label[$key]."".$key."".$type2label[$extrafields->attribute_type[$key]]."'.$extrafields->attribute_size[$key]."'.yn($extrafields->attribute_unique[$key])."'.yn($extrafields->attribute_required[$key])."'.img_edit().''; + print "  ".img_delete()."
"; + +dol_fiche_end(); + + +// Buttons +if ($action != 'create' && $action != 'edit') +{ + print '
'; + print "".$langs->trans("NewAttribute").""; + print "
"; +} + + +/* ************************************************************************** */ +/* */ +/* Creation d'un champ optionnel */ +/* */ +/* ************************************************************************** */ + +if ($action == 'create') +{ + print "
"; + print_titre($langs->trans('NewAttribute')); + + require DOL_DOCUMENT_ROOT.'/core/tpl/admin_extrafields_add.tpl.php'; +} + +/* ************************************************************************** */ +/* */ +/* Edition d'un champ optionnel */ +/* */ +/* ************************************************************************** */ +if ($action == 'edit' && ! empty($attrname)) +{ + print "
"; + print_titre($langs->trans("FieldEdition", $attrname)); + + require DOL_DOCUMENT_ROOT.'/core/tpl/admin_extrafields_edit.tpl.php'; +} + +llxFooter(); + +$db->close(); diff --git a/htdocs/admin/supplierorderdet_extrafields.php b/htdocs/admin/supplierorderdet_extrafields.php new file mode 100644 index 00000000000..20066aafab1 --- /dev/null +++ b/htdocs/admin/supplierorderdet_extrafields.php @@ -0,0 +1,159 @@ + + * Copyright (C) 2003 Jean-Louis Bergamo + * Copyright (C) 2004-2013 Laurent Destailleur + * Copyright (C) 2012 Regis Houssin + * Copyright (C) 2012 Florian Henry + * Copyright (C) 2013 Philippe Grand + * Copyright (C) 2015 Claudio Aschieri + * + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 3 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program. If not, see . + */ + +/** + * \file htdocs/admin/supplierorder_extrafields.php + * \ingroup fourn + * \brief Page to setup extra fields of supplierorder line + */ + +require '../main.inc.php'; +require_once DOL_DOCUMENT_ROOT.'/core/lib/fourn.lib.php'; +require_once DOL_DOCUMENT_ROOT.'/core/class/extrafields.class.php'; + + +if (!$user->admin) + accessforbidden(); + +$langs->load("admin"); +$langs->load("other"); +$langs->load("orders"); + +$extrafields = new ExtraFields($db); +$form = new Form($db); + +// List of supported format +$tmptype2label=ExtraFields::$type2label; +$type2label=array(''); +foreach ($tmptype2label as $key => $val) $type2label[$key]=$langs->trans($val); + +$action=GETPOST('action', 'alpha'); +$attrname=GETPOST('attrname', 'alpha'); +$elementtype='commande_fournisseurdet'; //Must be the $table_element of the class that manage extrafield + +if (!$user->admin) accessforbidden(); + + +/* + * Actions + */ + +require DOL_DOCUMENT_ROOT.'/core/actions_extrafields.inc.php'; + + + +/* + * View + */ + +$textobject=$langs->transnoentitiesnoconv("SuppliersOrders"); + +llxHeader('',$langs->trans("SuppliersSetup")); + +$linkback=''.$langs->trans("BackToModuleList").''; +print_fiche_titre($langs->trans("SuppliersSetup"),$linkback,'setup'); +print "
\n"; + +$head = supplierorder_admin_prepare_head(); + +dol_fiche_head($head, 'supplierorderdet', $langs->trans("Suppliers"), 0, 'company'); + + +print $langs->trans("DefineHereComplementaryAttributes",$textobject).'
'."\n"; +print '
'; + +// Load attribute_label +$extrafields->fetch_name_optionals_label($elementtype); + +print ""; + +print ''; +print ''; +print ''; +print ''; +print ''; +print ''; +print ''; +print ''; +print "\n"; + +$var=True; +foreach($extrafields->attribute_type as $key => $value) +{ + $var=!$var; + print ""; + print "\n"; + print "\n"; + print "\n"; + print '\n"; + print '\n"; + print '\n"; + print '\n"; + print ""; +} + +print "
'.$langs->trans("Label").''.$langs->trans("AttributeCode").''.$langs->trans("Type").''.$langs->trans("Size").''.$langs->trans("Unique").''.$langs->trans("Required").' 
".$extrafields->attribute_label[$key]."".$key."".$type2label[$extrafields->attribute_type[$key]]."'.$extrafields->attribute_size[$key]."'.yn($extrafields->attribute_unique[$key])."'.yn($extrafields->attribute_required[$key])."'.img_edit().''; + print "  ".img_delete()."
"; + +dol_fiche_end(); + + +// Buttons +if ($action != 'create' && $action != 'edit') +{ + print '
'; + print "".$langs->trans("NewAttribute").""; + print "
"; +} + + +/* ************************************************************************** */ +/* */ +/* Creation d'un champ optionnel */ +/* */ +/* ************************************************************************** */ + +if ($action == 'create') +{ + print "
"; + print_titre($langs->trans('NewAttribute')); + + require DOL_DOCUMENT_ROOT.'/core/tpl/admin_extrafields_add.tpl.php'; +} + +/* ************************************************************************** */ +/* */ +/* Edition d'un champ optionnel */ +/* */ +/* ************************************************************************** */ +if ($action == 'edit' && ! empty($attrname)) +{ + print "
"; + print_titre($langs->trans("FieldEdition", $attrname)); + + require DOL_DOCUMENT_ROOT.'/core/tpl/admin_extrafields_edit.tpl.php'; +} + +llxFooter(); + +$db->close(); diff --git a/htdocs/install/mysql/tables/llx_commande_fournisseurdet_extrafields.key.sql b/htdocs/install/mysql/tables/llx_commande_fournisseurdet_extrafields.key.sql new file mode 100644 index 00000000000..81e177d4aa3 --- /dev/null +++ b/htdocs/install/mysql/tables/llx_commande_fournisseurdet_extrafields.key.sql @@ -0,0 +1,19 @@ +-- ============================================================================ +-- Copyright (C) 2015 Claudio Aschieri +-- +-- This program is free software; you can redistribute it and/or modify +-- it under the terms of the GNU General Public License as published by +-- the Free Software Foundation; either version 3 of the License, or +-- (at your option) any later version. +-- +-- This program is distributed in the hope that it will be useful, +-- but WITHOUT ANY WARRANTY; without even the implied warranty of +-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +-- GNU General Public License for more details. +-- +-- You should have received a copy of the GNU General Public License +-- along with this program. If not, see . +-- +-- ============================================================================ + +ALTER TABLE llx_commande_fournisseurdet_extrafields ADD INDEX idx_commande_fournisseurdet_extrafields (fk_object); diff --git a/htdocs/install/mysql/tables/llx_commande_fournisseurdet_extrafields.sql b/htdocs/install/mysql/tables/llx_commande_fournisseurdet_extrafields.sql new file mode 100644 index 00000000000..c1ef550b761 --- /dev/null +++ b/htdocs/install/mysql/tables/llx_commande_fournisseurdet_extrafields.sql @@ -0,0 +1,30 @@ +-- =================================================================== +-- Copyright (C) 2004 Rodolphe Quiedeville +-- Copyright (C) 2005-2012 Regis Houssin +-- Copyright (C) 2007 Laurent Destailleur +-- Copyright (C) 2010 Juanjo Menent +-- Copyright (C) 2013 Florian HENRY +-- Copyright (C) 2015 Claudio Aschieri +-- +-- This program is free software; you can redistribute it and/or modify +-- it under the terms of the GNU General Public License as published by +-- the Free Software Foundation; either version 3 of the License, or +-- (at your option) any later version. +-- +-- This program is distributed in the hope that it will be useful, +-- but WITHOUT ANY WARRANTY; without even the implied warranty of +-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +-- GNU General Public License for more details. +-- +-- You should have received a copy of the GNU General Public License +-- along with this program. If not, see . +-- +-- =================================================================== + +create table llx_commande_fournisseurdet_extrafields +( + rowid integer AUTO_INCREMENT PRIMARY KEY, + tms timestamp, + fk_object integer NOT NULL, + import_key varchar(14) +) ENGINE=innodb; diff --git a/htdocs/install/mysql/tables/llx_facture_fourndet_extrafields.key.sql b/htdocs/install/mysql/tables/llx_facture_fourndet_extrafields.key.sql new file mode 100644 index 00000000000..11884f7c228 --- /dev/null +++ b/htdocs/install/mysql/tables/llx_facture_fourndet_extrafields.key.sql @@ -0,0 +1,20 @@ +-- =================================================================== +-- Copyright (C) 2015 Claudio Aschieri +-- +-- This program is free software; you can redistribute it and/or modify +-- it under the terms of the GNU General Public License as published by +-- the Free Software Foundation; either version 3 of the License, or +-- (at your option) any later version. +-- +-- This program is distributed in the hope that it will be useful, +-- but WITHOUT ANY WARRANTY; without even the implied warranty of +-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +-- GNU General Public License for more details. +-- +-- You should have received a copy of the GNU General Public License +-- along with this program. If not, see . +-- +-- =================================================================== + + +ALTER TABLE llx_facture_fourndet_extrafields ADD INDEX idx_facture_fourndet_extrafields (fk_object); diff --git a/htdocs/install/mysql/tables/llx_facture_fourndet_extrafields.sql b/htdocs/install/mysql/tables/llx_facture_fourndet_extrafields.sql new file mode 100644 index 00000000000..0f0ea67e52f --- /dev/null +++ b/htdocs/install/mysql/tables/llx_facture_fourndet_extrafields.sql @@ -0,0 +1,26 @@ +-- ======================================================================== +-- Copyright (C) 2015 Claudio Aschieri +-- +-- This program is free software; you can redistribute it and/or modify +-- it under the terms of the GNU General Public License as published by +-- the Free Software Foundation; either version 3 of the License, or +-- (at your option) any later version. +-- +-- This program is distributed in the hope that it will be useful, +-- but WITHOUT ANY WARRANTY; without even the implied warranty of +-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +-- GNU General Public License for more details. +-- +-- You should have received a copy of the GNU General Public License +-- along with this program. If not, see . +-- +-- ======================================================================== + +create table llx_facture_fourndet_extrafields +( + rowid integer AUTO_INCREMENT PRIMARY KEY, + tms timestamp, + fk_object integer NOT NULL, + import_key varchar(14) -- import key +) ENGINE=innodb; + From c8480efbef421104a8746a9b585b614c98c0fda1 Mon Sep 17 00:00:00 2001 From: cla Date: Thu, 22 Jan 2015 15:01:27 +0100 Subject: [PATCH 3/5] update table name facture fourn det extrafields --- ...rafields.key.sql => llx_facture_fourn_det_extrafields.key.sql} | 0 ...ndet_extrafields.sql => llx_facture_fourn_det_extrafields.sql} | 0 2 files changed, 0 insertions(+), 0 deletions(-) rename htdocs/install/mysql/tables/{llx_facture_fourndet_extrafields.key.sql => llx_facture_fourn_det_extrafields.key.sql} (100%) rename htdocs/install/mysql/tables/{llx_facture_fourndet_extrafields.sql => llx_facture_fourn_det_extrafields.sql} (100%) diff --git a/htdocs/install/mysql/tables/llx_facture_fourndet_extrafields.key.sql b/htdocs/install/mysql/tables/llx_facture_fourn_det_extrafields.key.sql similarity index 100% rename from htdocs/install/mysql/tables/llx_facture_fourndet_extrafields.key.sql rename to htdocs/install/mysql/tables/llx_facture_fourn_det_extrafields.key.sql diff --git a/htdocs/install/mysql/tables/llx_facture_fourndet_extrafields.sql b/htdocs/install/mysql/tables/llx_facture_fourn_det_extrafields.sql similarity index 100% rename from htdocs/install/mysql/tables/llx_facture_fourndet_extrafields.sql rename to htdocs/install/mysql/tables/llx_facture_fourn_det_extrafields.sql From 134759ce28efa7dca05fc9831621fadbcb5411af Mon Sep 17 00:00:00 2001 From: cla Date: Thu, 22 Jan 2015 15:02:19 +0100 Subject: [PATCH 4/5] update table name facture_fourn_det_extrafields --- htdocs/admin/supplierinvoicedet_extrafields.php | 2 +- .../mysql/tables/llx_facture_fourn_det_extrafields.key.sql | 2 +- .../install/mysql/tables/llx_facture_fourn_det_extrafields.sql | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/htdocs/admin/supplierinvoicedet_extrafields.php b/htdocs/admin/supplierinvoicedet_extrafields.php index b8525601a61..3596fc50d72 100644 --- a/htdocs/admin/supplierinvoicedet_extrafields.php +++ b/htdocs/admin/supplierinvoicedet_extrafields.php @@ -52,7 +52,7 @@ foreach ($tmptype2label as $key => $val) $type2label[$key]=$langs->trans($val); $action=GETPOST('action', 'alpha'); $attrname=GETPOST('attrname', 'alpha'); -$elementtype='facture_fourndet'; //Must be the $table_element of the class that manage extrafield +$elementtype='facture_fourn_det'; //Must be the $table_element of the class that manage extrafield if (!$user->admin) accessforbidden(); diff --git a/htdocs/install/mysql/tables/llx_facture_fourn_det_extrafields.key.sql b/htdocs/install/mysql/tables/llx_facture_fourn_det_extrafields.key.sql index 11884f7c228..2ba04f4b256 100644 --- a/htdocs/install/mysql/tables/llx_facture_fourn_det_extrafields.key.sql +++ b/htdocs/install/mysql/tables/llx_facture_fourn_det_extrafields.key.sql @@ -17,4 +17,4 @@ -- =================================================================== -ALTER TABLE llx_facture_fourndet_extrafields ADD INDEX idx_facture_fourndet_extrafields (fk_object); +ALTER TABLE llx_facture_fourn_det_extrafields ADD INDEX idx_facture_fourn_det_extrafields (fk_object); diff --git a/htdocs/install/mysql/tables/llx_facture_fourn_det_extrafields.sql b/htdocs/install/mysql/tables/llx_facture_fourn_det_extrafields.sql index 0f0ea67e52f..4faca1a4865 100644 --- a/htdocs/install/mysql/tables/llx_facture_fourn_det_extrafields.sql +++ b/htdocs/install/mysql/tables/llx_facture_fourn_det_extrafields.sql @@ -16,7 +16,7 @@ -- -- ======================================================================== -create table llx_facture_fourndet_extrafields +create table llx_facture_fourn_det_extrafields ( rowid integer AUTO_INCREMENT PRIMARY KEY, tms timestamp, From 11179e5537b93425d871eef81622214069f0a9bd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Rapha=C3=ABl=20Doursenaud?= Date: Fri, 23 Jan 2015 16:12:59 +0100 Subject: [PATCH 5/5] Updated and revamped readme --- README.md | 231 +++++++++++++++++++++++++++++------------------------- 1 file changed, 123 insertions(+), 108 deletions(-) diff --git a/README.md b/README.md index 93b9d275beb..4c9ffa93080 100644 --- a/README.md +++ b/README.md @@ -1,151 +1,166 @@ # DOLIBARR ERP & CRM -Dolibarr ERP & CRM is a modern software to manage your company or foundation activity (contacts, suppliers, invoices, orders, stocks, agenda, ...).It's an opensource software (wrote with PHP language) designed for small and medium companies, foundation and freelances. You can freely install, use and distribute it as a standalone application or as a web application to use it from every internet access and media. +Dolibarr ERP & CRM is a modern software to manage your organization's activity (contacts, suppliers, invoices, orders, stocks, agenda, ...). + +It's an Open Source software (wrote in PHP language) designed for small and medium companies, foundation and freelances. + +You can freely use, study, modify or distribute it according to it's Free Software licence. + +You can use it as a standalone application or as a web application to be able to access it from the Internet or a LAN. ![ScreenShot](http://www.dolibarr.org/images/dolibarr_screenshot1_640x400.png) - ## LICENSE Dolibarr is released under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version (GPL-3+). +See the [COPYING](COPYING) file for a full copy of the license. +Other licenses apply for some included dependencies. See [COPYRIGHT](COPYRIGHT) for a full list. -## INSTALL +## INSTALLING -If you have no technical knowledge, and you are looking for an autoinstaller to install Dolibarr ERP/CRM in few clicks, you must download DoliWamp (the all-in-one package of Dolibarr for Windows), DoliDeb (the all-in-one package of Dolibarr for Debian or Ubuntu) or DoliRpm (the all-in-one package of Dolibarr for Fedora, Redhat, Opensuse, Mandriva or Mageia). +### Download -You can download this at: [Official website] () +Official releases are available on the [website](http://www.dolibarr.org/downloads). -If you already have installed a Web server and a Mysql database, you can install the standard version like this: +### Simple setup -- Uncompress the downloaded archive. +If you have low technical skills and you're looking to install Dolibarr ERP/CRM in few clicks, you can use one of the packaged versions: -- Copy directory "dolibarr" and all its files inside your web server root, or copy directory anywhere and set up your web server to use "dolibarr/htdocs" as root for a new web server virtual host (second choice need to be server administrator). - -- Create an empty file "htdocs/conf/conf.php" and set permissions for your web server user (write permissions will be removed once install is finished). - -- From your browser, call the dolibarr "install/" page. +- DoliWamp for Windows +- DoliDeb for Debian or Ubuntu +- DoliRpm for Redhat, Fedora, OpenSuse, Mandriva or Mageia -Url depends on choice made on first step: +### Advanced setup - http://localhost/dolibarr/htdocs/install/ -or +You can use a Web server and a supported database (MySQL recommended) to install the standard version. - http://localhost/dolibarr/install/ -or +- Uncompress the downloaded archive +- Copy directory "dolibarr" and all its files inside your web server root, or copy directory anywhere and set up your web server to use "dolibarr/htdocs" as root for a new web server virtual host (second choice need to be server administrator) +- Create an empty file "htdocs/conf/conf.php" and set permissions for your web server user (write permissions will be removed once install is finished) +- From your browser, go to the dolibarr "install/" page - http://yourdolibarrvirtualhost/install/ + The URL will depends on choices made in the first step: + + http://localhost/dolibarr/htdocs/install/ + + or + + http://localhost/dolibarr/install/ + + or + + http://yourdolibarrvirtualhost/install/ -- Follow instructions provided by installer... +- Follow the installer instructions +## UPGRADING +- Overwrite all old files from 'dolibarr' directory with files provided into the new version's package. +- If you're upgrading from version x.y.z to x.y.w (only third number differs), there is no need to run any migration process +- If you're upgrading from a beta version or from any version x.y.z to any other where x or y number differs, you must call the Dolibarr "install/" page in your browser (this should be done automatically at first dolibarr access) and follow the upgrade process. +- +*Note: migration process can safely be done multiple times.* -## UPGRADE +## NEWS -To upgrade Dolibarr from an old version to this one: +See the [ChangeLog](ChangeLog) file. -- Overwrite all old files inside old 'dolibarr' directory by files provided into new version package. - -- If you came from version x.y.z to x.y.w (only third number differ), there is no need to run any migrate process. - -- If you came from a beta version or from any version x.y.z to any other where x or y number differs, you must call the Dolibarr "install/" page in your browser (this should be done automatically at first dolibarr access). +## FEATURES -This URL should looks like: +### General features +- Users and groups with finely grained rights +- Localization in most major languages +- Very user friendly and easy to use +- Highly customizable: enable only the modules you need, add user personalized fields, choose your skin, several menu managers (can be used by internal users as a back-office with a particular menu, or by external users as a front-office with another one) +- Works with PHP 5.3+ and MySQL 4.1+ or PostgreSQL 8.1. (See requirements on the [Wiki](http://wiki.dolibarr.org/index.php/Prerequisite)) +- Compatible with all Cloud solutions that match MySQL, PHP or PostgreSQL prerequisites. +- An easy to understand, maintain and code interfaces with your own information system (PHP with no heavy framework; trigger and hook architecture) +- Support for country specific features: + - Spanish Tax RE and ISPF + - French NPR VAT rate (VAT called "Non Perçue Récupérable" for DOM-TOM) + - Canadian double taxes (federal/province) and other countries using cumulative VAT + - Tunisian tax stamp + - Compatible with [European directives](http://europa.eu/legislation_summaries/taxation/l31057_en.htm) (2006/112/CE ... 2010/45/UE) +- ... - http://localhost/dolibarr/htdocs/install/ -or +### Main modules - http://localhost/dolibarr/install/ -or - - http://yourdolibarrhost/install/ - -Then choose the "update" option according to your case. -Note: Migrate process can be ran safely several times. - - - -## WHAT'S NEW - -See ChangeLog file found into package. - - - -## WHAT DOLIBARR CAN DO - -### Main modules/features: - -- Customers, Prospects or Suppliers directory. -- Products and services catalog. -- Bank accounts management. -- Orders management. -- Commercial proposals management. -- Contracts management. -- Invoices management. -- Payments management. -- Standing orders management. -- Stock management. -- Shipping management. +- Customers, Prospects and/or Suppliers directory +- Products and/or Services catalog +- Bank accounts management +- Customer and Supplier Orders management +- Commercial proposals management +- Contracts management +- Invoices management +- Projects management +- Events management +- Payments management +- Standing orders management +- Stock management +- Shipping management +- Interventions management - PDF or ODT generation for invoice, proposals, orders... -- Agenda with ical,vcal export for third tools integration. -- EDM (Electronic Document Management). -- Foundations members management. -- Employee's holidays management. -- Mass Emailing. -- Realize surveys. -- Point of Sale. +- Agenda with ical and vcal export for third party tools integration +- Electronic Document Management (EDM) +- Foundations members management +- Employee's holidays management +- Mass emailing +- Surveys +- Point of Sale +- … -### Other modules: +### Other modules -- Bookmarks management. -- Donations management. -- Reporting. -- Data export/import. -- Third parties or products categories. -- LDAP connectivity. -- ClickToDial integration. -- RSS integration. -- Can be extended with a lot of other external modules available onto DoliStore.com. +- Bookmarks management +- Donations management +- Reporting +- Data export/import +- Thirdparties and/or products categories +- Barcodes support +- Margin calculations +- LDAP connectivity +- ClickToDial integration +- RSS integration +- Skype integration +- Payment platforms integration (PayBox, PayPal) +- … -### Miscellaneous: +### Extending -- Multi-user, with several permissions levels for each feature. -- Very user friendly and easy to use. -- Highly customizable: Enable only modules you need, user personalized fields, choose your skin, several menu managers (can be used by internal users as a back-office with a particular menu, or by external users as a front-office with another one). -- Works with PHP 5.3+, MySql 4.1 or PostgreSQL 8.1. -- Require PHP and Mysql or Postgresql (See exatc versions on http://wiki.dolibarr.org/index.php/Prerequisite). -- Compatible with all Cloud solutions that match MySql, PHP or PostgreSQL prerequisites. -- An easy to understand, maintain and code interfaces with your own system information (PHP with no heavy frameworks, trigger and hook architecture). -- Support countries specific features: - Spanish Tax RE and ISPF. - French NPR VAT rate (VAT called "Non Perçue Récupérable" for DOM-TOM). - Canadian double taxes (federal/province) and other countries using cumulative VAT. - Tunisian tax stamp. - Compatible with European directives (2006/112/CE ... 2010/45/UE) (http://europa.eu/legislation_summaries/taxation/l31057_en.htm) - ... +Dolibarr can be extended with a lot of other external modules from third party developers available at the [DoliStore](http://www.dolistore.com). +## FUTURE -## WHAT DOLIBARR CAN'T DO YET (TODO LIST) +These are features that Dolibarr does **not** yet fully support: -This is features that Dolibarr does not support completely yet: +- Double-entry bookkeeping (only bank and treasury management) +- Multiple currencies +- Multiple companies + If you want to manage several companies or foundations, you must install the software several times (on same server or not) or use the MultiCompany addon module that allows to manage several companies in one Dolibarr instance (one database but with a logical isolation of datas) +- Tasks dependencies in projects +- Payroll module +- Webmail +- Dolibarr can't do coffee (yet) -- No double party accountancy (only bank and treasury management). -- Dolibarr manage one currency at once (mono-currency). -- Dolibarr manage one master activity (mono-company). If you want to manage several companies or foundations, you must install several time the software (on same server or not). Another solution is to extend Dolibarr with the addon Module MultiCompany that allows to manage several companies in one Dolibarr instance (one database but with a logical isolation of datas). -- Tasks on module project can't have dependencies between each other. -- Dolibarr does not contains Payroll module. -- Dolibarr does not include any Webmail. -- Dolibarr can't do coffee (not yet). +## DOCUMENTATION +Administrator, user, developer and translator's documentations are available along with other community resources on the [Wiki](http://wiki.dolibarr.org). + +## CREDITS + +Dolibarr is the work of many contributors over the years and uses some fine libraries. + +See [COPYRIGHT](COPYRIGHT) file. ## SOCIAL NETWORKS -Follow Dolibarr project on - -Facebook: - -Google+: - -Twitter: +Follow Dolibarr project on: +- [Facebook](https://www.facebook.com/dolibarr) +- [Google+](https://plus.google.com/+DolibarrOrg) +- [Twitter](http://www.twitter.com/dolibarr) +- [LinkedIn](http://https//www.linkedin.com/groups/Dolibarr-ERP-CRM-2743052?gid=2743052) +- [YouTube](https://www.youtube.com/user/DolibarrERPCRM) +- [GitHub](https://github.com/Dolibarr/dolibarr)