Completed
Branch develop (2a8f23)
by
unknown
26:18
created

modProjet::init()   B

Complexity

Conditions 7
Paths 7

Size

Total Lines 55
Code Lines 32

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 7
eloc 32
nc 7
nop 1
dl 0
loc 55
rs 7.8235
c 0
b 0
f 0

How to fix   Long Method   

Long Method

Small methods make your code easier to understand, in particular if combined with a good name. Besides, if your method is small, finding a good name is usually much easier.

For example, if you find yourself adding comments to a method's body, this is usually a good sign to extract the commented part to a new method, and use the comment as a starting point when coming up with a good name for this new method.

Commonly applied refactorings include:

1
<?php
2
/* Copyright (C) 2003-2005 Rodolphe Quiedeville <[email protected]>
3
 * Copyright (C) 2004-2014 Laurent Destailleur  <[email protected]>
4
 * Copyright (C) 2004      Sebastien Di Cintio  <[email protected]>
5
 * Copyright (C) 2004      Benoit Mortier       <[email protected]>
6
 * Copyright (C) 2005-2012 Regis Houssin        <[email protected]>
7
 * Copyright (C) 2013	   Florian Henry        <[email protected]>
8
 * Copyright (C) 2014	   Charles-Fr BENKE	<[email protected]>
9
 *
10
 * This program is free software; you can redistribute it and/or modify
11
 * it under the terms of the GNU General Public License as published by
12
 * the Free Software Foundation; either version 3 of the License, or
13
 * (at your option) any later version.
14
 *
15
 * This program is distributed in the hope that it will be useful,
16
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18
 * GNU General Public License for more details.
19
 *
20
 * You should have received a copy of the GNU General Public License
21
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
22
 */
23
24
/**
25
 *  \defgroup   projet     Module project
26
 *	\brief      Module to create projects/tasks/gantt diagram. Projects can them be affected to tasks.
27
 *  \file       htdocs/core/modules/modProjet.class.php
28
 *	\ingroup    projet
29
 *	\brief      Fichier de description et activation du module Projet
30
 */
31
include_once DOL_DOCUMENT_ROOT .'/core/modules/DolibarrModules.class.php';
32
33
34
/**
35
 *	Class to describe and enable module Projet
36
 */
37
class modProjet extends DolibarrModules
38
{
39
40
	/**
41
	 *   Constructor. Define names, constants, directories, boxes, permissions
42
	 *
43
	 *   @param      DoliDB		$db      Database handler
44
	 */
45
	function __construct($db)
46
	{
47
		global $conf;
48
49
		$this->db = $db;
50
		$this->numero = 400;
51
52
		$this->family = "projects";
53
		$this->module_position = 10;
54
		// Module label (no space allowed), used if translation string 'ModuleXXXName' not found (where XXX is value of numeric property 'numero' of module)
55
		$this->name = preg_replace('/^mod/i','',get_class($this));
56
		$this->description = "Gestion des projets";
57
		// Possible values for version are: 'development', 'experimental', 'dolibarr' or version
58
		$this->version = 'dolibarr';
59
60
		$this->const_name = 'MAIN_MODULE_'.strtoupper($this->name);
61
		$this->special = 0;
62
		$this->config_page_url = array("project.php@projet");
63
		$this->picto='project';
64
65
		// Data directories to create when module is enabled
66
		$this->dirs = array("/projet/temp");
67
68
		// Dependancies
69
		$this->depends = array();
70
		$this->requiredby = array();
71
		$this->conflictwith = array();
72
		$this->langfiles = array('projects');
73
74
		// Constants
75
		$this->const = array();
76
		$r=0;
77
78
		$this->const[$r][0] = "PROJECT_ADDON_PDF";
79
		$this->const[$r][1] = "chaine";
80
		$this->const[$r][2] = "baleine";
81
		$this->const[$r][3] = 'Name of PDF/ODT project manager class';
82
		$this->const[$r][4] = 0;
83
		$r++;
84
85
		$this->const[$r][0] = "PROJECT_ADDON";
86
		$this->const[$r][1] = "chaine";
87
		$this->const[$r][2] = "mod_project_simple";
88
		$this->const[$r][3] = 'Name of Numbering Rule project manager class';
89
		$this->const[$r][4] = 0;
90
		$r++;
91
92
		$this->const[$r][0] = "PROJECT_ADDON_PDF_ODT_PATH";
93
		$this->const[$r][1] = "chaine";
94
		$this->const[$r][2] = "DOL_DATA_ROOT/doctemplates/projects";
95
		$this->const[$r][3] = "";
96
		$this->const[$r][4] = 0;
97
		$r++;
98
99
		$this->const[$r][0] = "PROJECT_TASK_ADDON_PDF";
100
		$this->const[$r][1] = "chaine";
101
		$this->const[$r][2] = "";
102
		$this->const[$r][3] = 'Name of PDF/ODT tasks manager class';
103
		$this->const[$r][4] = 0;
104
		$r++;
105
106
		$this->const[$r][0] = "PROJECT_TASK_ADDON";
107
		$this->const[$r][1] = "chaine";
108
		$this->const[$r][2] = "mod_task_simple";
109
		$this->const[$r][3] = 'Name of Numbering Rule task manager class';
110
		$this->const[$r][4] = 0;
111
		$r++;
112
113
		$this->const[$r][0] = "PROJECT_TASK_ADDON_PDF_ODT_PATH";
114
		$this->const[$r][1] = "chaine";
115
		$this->const[$r][2] = "DOL_DATA_ROOT/doctemplates/tasks";
116
		$this->const[$r][3] = "";
117
		$this->const[$r][4] = 0;
118
		$r++;
119
		                       
120
		$this->const[$r][0] = "PROJECT_USE_OPPORTUNITIES";
121
		$this->const[$r][1] = "chaine";
122
		$this->const[$r][2] = "1";
123
		$this->const[$r][3] = "";
124
		$this->const[$r][4] = 0;
125
		$r++;
126
		
127
		$this->const[$r][0] = "MAIN_DELAY_PROJECT_TO_CLOSE";
128
		$this->const[$r][1] = "chaine";
129
		$this->const[$r][2] = "7";
130
		$this->const[$r][3] = "";
131
		$this->const[$r][4] = 0;
132
		$r++;
133
		$this->const[$r][0] = "MAIN_DELAY_TASKS_TODO";
134
		$this->const[$r][1] = "chaine";
135
		$this->const[$r][2] = "7";
136
		$this->const[$r][3] = "";
137
		$this->const[$r][4] = 0;
138
		$r++;
139
		
140
		// Boxes
141
		$this->boxes = array();
142
		$r=0;
143
		$this->boxes[$r][1] = "box_project.php";
144
		$r++;
145
		$this->boxes[$r][1] = "box_task.php";
146
		$r++;
147
148
		// Permissions
149
		$this->rights = array();
150
		$this->rights_class = 'projet';
151
		$r=0;
152
153
		$r++;
154
		$this->rights[$r][0] = 41; // id de la permission
155
		$this->rights[$r][1] = "Read projects and tasks (shared projects or projects I am contact for). Can also enter time consumed on assigned tasks (timesheet)"; // libelle de la permission
156
		$this->rights[$r][2] = 'r'; // type de la permission (deprecie a ce jour)
157
		$this->rights[$r][3] = 0; // La permission est-elle une permission par defaut
158
		$this->rights[$r][4] = 'lire';
159
160
		$r++;
161
		$this->rights[$r][0] = 42; // id de la permission
162
		$this->rights[$r][1] = "Create/modify projects and tasks (shared projects or projects I am contact for)"; // libelle de la permission
163
		$this->rights[$r][2] = 'w'; // type de la permission (deprecie a ce jour)
164
		$this->rights[$r][3] = 0; // La permission est-elle une permission par defaut
165
		$this->rights[$r][4] = 'creer';
166
167
		$r++;
168
		$this->rights[$r][0] = 44; // id de la permission
169
		$this->rights[$r][1] = "Delete project and tasks (shared projects or projects I am contact for)"; // libelle de la permission
170
		$this->rights[$r][2] = 'd'; // type de la permission (deprecie a ce jour)
171
		$this->rights[$r][3] = 0; // La permission est-elle une permission par defaut
172
		$this->rights[$r][4] = 'supprimer';
173
174
		$r++;
175
		$this->rights[$r][0] = 45; // id de la permission
176
		$this->rights[$r][1] = "Export projects"; // libelle de la permission
177
		$this->rights[$r][2] = 'd'; // type de la permission (deprecie a ce jour)
178
		$this->rights[$r][3] = 0; // La permission est-elle une permission par defaut
179
		$this->rights[$r][4] = 'export';
180
181
		$r++;
182
		$this->rights[$r][0] = 141; // id de la permission
183
		$this->rights[$r][1] = "Read all projects and tasks (also private projects I am not contact for)"; // libelle de la permission
184
		$this->rights[$r][2] = 'r'; // type de la permission (deprecie a ce jour)
185
		$this->rights[$r][3] = 0; // La permission est-elle une permission par defaut
186
		$this->rights[$r][4] = 'all';
187
		$this->rights[$r][5] = 'lire';
188
189
		$r++;
190
		$this->rights[$r][0] = 142; // id de la permission
191
		$this->rights[$r][1] = "Create/modify all projects and tasks (also private projects I am not contact for)"; // libelle de la permission
192
		$this->rights[$r][2] = 'w'; // type de la permission (deprecie a ce jour)
193
		$this->rights[$r][3] = 0; // La permission est-elle une permission par defaut
194
		$this->rights[$r][4] = 'all';
195
		$this->rights[$r][5] = 'creer';
196
197
		$r++;
198
		$this->rights[$r][0] = 144; // id de la permission
199
		$this->rights[$r][1] = "Delete all projects and tasks (also private projects I am not contact for)"; // libelle de la permission
200
		$this->rights[$r][2] = 'd'; // type de la permission (deprecie a ce jour)
201
		$this->rights[$r][3] = 0; // La permission est-elle une permission par defaut
202
		$this->rights[$r][4] = 'all';
203
		$this->rights[$r][5] = 'supprimer';
204
205
206
		// Menus
207
		//-------
208
		$this->menu = 1;        // This module add menu entries. They are coded into menu manager.
0 ignored issues
show
Documentation Bug introduced by
It seems like 1 of type integer is incompatible with the declared type array of property $menu.

Our type inference engine has found an assignment to a property that is incompatible with the declared type of that property.

Either this assignment is in error or the assigned type should be added to the documentation/type hint for that property..

Loading history...
209
210
		
211
		//Exports
212
		//--------
213
		$r=1;
214
215
		$this->export_code[$r]=$this->rights_class.'_'.$r;
216
		$this->export_label[$r]='ProjectsAndTasksLines';	// Translation key (used only if key ExportDataset_xxx_z not found)
217
		$this->export_permission[$r]=array(array("projet","export"));
218
		$this->export_dependencies_array[$r]=array('projecttask'=>'pt.rowid', 'task_time'=>'ptt.rowid');
219
220
		$this->export_TypeFields_array[$r]=array('s.rowid'=>"List:societe:nom",'s.nom'=>'Text','s.address'=>'Text','s.zip'=>'Text','s.town'=>'Text','s.fk_pays'=>'List:c_country:label',
221
		's.phone'=>'Text','s.siren'=>'Text','s.siret'=>'Text','s.ape'=>'Text','s.idprof4'=>'Text','s.code_compta'=>'Text','s.code_compta_fournisseur'=>'Text',
222
		'p.rowid'=>"List:projet:ref",'p.ref'=>"Text",'p.datec'=>"Date",'p.dateo'=>"Date",'p.datee'=>"Date",'p.fk_statut'=>'Status','cls.code'=>"Text",'p.opp_percent'=>'Numeric','p.description'=>"Text",
223
		'pt.rowid'=>'Text','pt.label'=>'Text','pt.dateo'=>"Date",'pt.datee'=>"Date",'pt.duration_effective'=>"Duree",'pt.planned_workload'=>"Numeric",'pt.progress'=>"Numeric",'pt.description'=>"Text",
224
		'ptt.rowid'=>'Numeric','ptt.task_date'=>'Date','ptt.task_duration'=>"Duree",'ptt.fk_user'=>"List:user:CONCAT(lastname,' ',firstname)",'ptt.note'=>"Text");
225
226
		$this->export_entities_array[$r]=array('s.rowid'=>"company",'s.nom'=>'company','s.address'=>'company','s.zip'=>'company','s.town'=>'company','s.fk_pays'=>'company',
227
		's.phone'=>'company','s.siren'=>'company','s.siret'=>'company','s.ape'=>'company','s.idprof4'=>'company','s.code_compta'=>'company','s.code_compta_fournisseur'=>'company',
228
		'p.rowid'=>"project",'p.ref'=>"project",'p.datec'=>"project",'p.dateo'=>"project",'p.datee'=>"project",'p.duree'=>"project",'p.fk_statut'=>"project",'cls.code'=>"project",'p.opp_percent'=>'project','p.description'=>"project");
229
230
		$this->export_fields_array[$r]=array('s.rowid'=>"IdCompany",'s.nom'=>'CompanyName','s.address'=>'Address','s.zip'=>'Zip','s.town'=>'Town','s.fk_pays'=>'Country',
231
		's.phone'=>'Phone','s.siren'=>'ProfId1','s.siret'=>'ProfId2','s.ape'=>'ProfId3','s.idprof4'=>'ProfId4','s.code_compta'=>'CustomerAccountancyCode','s.code_compta_fournisseur'=>'SupplierAccountancyCode',
232
		'p.rowid'=>"ProjectId",'p.ref'=>"RefProject",'p.datec'=>"DateCreation",'p.dateo'=>"DateStart",'p.datee'=>"DateEnd",'p.fk_statut'=>'ProjectStatus','cls.code'=>'OpportunityStatus','p.opp_percent'=>'OpportunityProbability','p.description'=>"Description");
233
234
		// Add fields for project
235
		$this->export_fields_array[$r]=array_merge($this->export_fields_array[$r], array());
236
		$keyforselect='projet'; $keyforelement='project'; $keyforaliasextra='extra';
237
		include DOL_DOCUMENT_ROOT.'/core/extrafieldsinexport.inc.php';
238
		// Add fields for tasks
239
        $this->export_fields_array[$r]=array_merge($this->export_fields_array[$r], array('pt.rowid'=>'RefTask','pt.label'=>'LabelTask','pt.dateo'=>"TaskDateStart",'pt.datee'=>"TaskDateEnd",'pt.duration_effective'=>"DurationEffective",'pt.planned_workload'=>"PlannedWorkload",'pt.progress'=>"Progress",'pt.description'=>"TaskDescription"));
240
		$this->export_entities_array[$r]=array_merge($this->export_entities_array[$r], array('pt.rowid'=>'projecttask','pt.label'=>'projecttask','pt.dateo'=>"projecttask",'pt.datee'=>"projecttask",'pt.duration_effective'=>"projecttask",'pt.planned_workload'=>"projecttask",'pt.progress'=>"projecttask",'pt.description'=>"projecttask"));
241
        // Add extra fields
242
		$keyforselect='projet_task'; $keyforelement='projecttask'; $keyforaliasextra='extra2';
243
		include DOL_DOCUMENT_ROOT.'/core/extrafieldsinexport.inc.php';
244
        // End add extra fields
245
		$this->export_fields_array[$r]=array_merge($this->export_fields_array[$r], array('ptt.rowid'=>'IdTaskTime','ptt.task_date'=>'TaskTimeDate','ptt.task_duration'=>"TimesSpent",'ptt.fk_user'=>"TaskTimeUser",'ptt.note'=>"TaskTimeNote"));
246
        $this->export_entities_array[$r]=array_merge($this->export_entities_array[$r], array('ptt.rowid'=>'task_time','ptt.task_date'=>'task_time','ptt.task_duration'=>"task_time",'ptt.fk_user'=>"task_time",'ptt.note'=>"task_time"));
247
248
        $this->export_sql_start[$r]='SELECT DISTINCT ';
249
		$this->export_sql_end[$r]  =' FROM '.MAIN_DB_PREFIX.'projet as p';
250
        $this->export_sql_end[$r] .=' LEFT JOIN '.MAIN_DB_PREFIX.'projet_extrafields as extra ON p.rowid = extra.fk_object';
251
        $this->export_sql_end[$r] .=' LEFT JOIN '.MAIN_DB_PREFIX.'c_lead_status as cls ON p.fk_opp_status = cls.rowid';
252
        $this->export_sql_end[$r] .=' LEFT JOIN '.MAIN_DB_PREFIX."projet_task as pt ON p.rowid = pt.fk_projet";
253
        $this->export_sql_end[$r] .=' LEFT JOIN '.MAIN_DB_PREFIX.'projet_task_extrafields as extra2 ON pt.rowid = extra2.fk_object';
254
		$this->export_sql_end[$r] .=' LEFT JOIN '.MAIN_DB_PREFIX."projet_task_time as ptt ON pt.rowid = ptt.fk_task";
255
		$this->export_sql_end[$r] .=' LEFT JOIN '.MAIN_DB_PREFIX.'societe as s ON p.fk_soc = s.rowid';
256
		$this->export_sql_end[$r] .=' WHERE p.entity = '.$conf->entity;
257
		
258
		
259
		// Import list of tasks
260
		if (empty($conf->global->PROJECT_HIDE_TASKS))
261
		{
262
    		$r++;
263
    		$this->import_code[$r]='tasksofprojects';
264
    		$this->import_label[$r]='ImportDatasetTasks';
265
    		$this->import_icon[$r]='task';
266
    		$this->import_entities_array[$r]=array('t.fk_projet'=>'project');	// We define here only fields that use another icon that the one defined into import_icon
267
    		$this->import_tables_array[$r]=array('t'=>MAIN_DB_PREFIX.'projet_task','extra'=>MAIN_DB_PREFIX.'projet_task_extrafields');	// List of tables to insert into (insert done in same order)
268
    		$this->import_fields_array[$r]=array('t.fk_projet'=>'ProjectRef*','t.ref'=>'RefTask*','t.label'=>'LabelTask*','t.dateo'=>"DateStart",'t.datee'=>"DateEnd",'t.planned_workload'=>"PlannedWorkload",'t.progress'=>"Progress",'t.note_private'=>"NotePrivate",'t.note_public'=>"NotePublic",'t.datec'=>"DateCreation");
269
    		// Add extra fields
270
    		$sql="SELECT name, label, fieldrequired FROM ".MAIN_DB_PREFIX."extrafields WHERE elementtype = 'projet_task' AND entity = ".$conf->entity;
271
    		$resql=$this->db->query($sql);
272
    		if ($resql)    // This can fail when class is used on old database (during migration for example)
273
    		{
274
    		    while ($obj=$this->db->fetch_object($resql))
275
    		    {
276
    		        $fieldname='extra.'.$obj->name;
277
    		        $fieldlabel=ucfirst($obj->label);
278
    		        $this->import_fields_array[$r][$fieldname]=$fieldlabel.($obj->fieldrequired?'*':'');
279
    		    }
280
    		}
281
    		// End add extra fields
282
    		$this->import_fieldshidden_array[$r]=array('t.fk_user_creat'=>'user->id','extra.fk_object'=>'lastrowid-'.MAIN_DB_PREFIX.'projet_task');    // aliastable.field => ('user->id' or 'lastrowid-'.tableparent)
283
    		$this->import_convertvalue_array[$r]=array(
284
    		    't.fk_projet'=>array('rule'=>'fetchidfromref','classfile'=>'/projet/class/project.class.php','class'=>'Project','method'=>'fetch','element'=>'Project'),
285
    		    't.ref'=>array('rule'=>'getrefifauto')
286
    		);
287
    		//$this->import_convertvalue_array[$r]=array('s.fk_soc'=>array('rule'=>'lastrowid',table='t');
288
    		$this->import_regex_array[$r]=array('t.dateo'=>'^[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]$','t.datee'=>'^[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]$','t.datec'=>'^[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]( [0-9][0-9]:[0-9][0-9]:[0-9][0-9])?$');
289
    		$this->import_examplevalues_array[$r]=array('t.fk_projet'=>'MyProjectRef','t.ref'=>"auto or TK2010-1234",'t.label'=>"My task",'t.progress'=>"0 (not started) to 100 (finished)",'t.datec'=>'1972-10-10','t.note_private'=>"My private note",'t.note_public'=>"My public note");
290
		}		
291
	}
292
293
294
	/**
295
	 *		Function called when module is enabled.
296
	 *		The init function add constants, boxes, permissions and menus (defined in constructor) into Dolibarr database.
297
	 *		It also creates data directories
298
	 *
299
     *      @param      string	$options    Options when enabling module ('', 'noboxes')
300
	 *      @return     int             	1 if OK, 0 if KO
301
	 */
302
	function init($options='')
303
	{
304
		global $conf,$langs;
305
306
		// Permissions
307
		$this->remove($options);
308
309
		//ODT template for project
310
		$src=DOL_DOCUMENT_ROOT.'/install/doctemplates/projects/template_project.odt';
311
		$dirodt=DOL_DATA_ROOT.'/doctemplates/projects';
312
		$dest=$dirodt.'/template_project.odt';
313
314
		if (file_exists($src) && ! file_exists($dest))
315
		{
316
			require_once DOL_DOCUMENT_ROOT.'/core/lib/files.lib.php';
317
			dol_mkdir($dirodt);
318
			$result=dol_copy($src,$dest,0,0);
319
			if ($result < 0)
320
			{
321
				$langs->load("errors");
322
				$this->error=$langs->trans('ErrorFailToCopyFile',$src,$dest);
323
				return 0;
324
			}
325
		}
326
327
		//ODT template for tasks
328
		$src=DOL_DOCUMENT_ROOT.'/install/doctemplates/tasks/template_task_summary.odt';
329
		$dirodt=DOL_DATA_ROOT.'/doctemplates/tasks';
330
		$dest=$dirodt.'/template_task_summary.odt';
331
332
		if (file_exists($src) && ! file_exists($dest))
333
		{
334
			require_once DOL_DOCUMENT_ROOT.'/core/lib/files.lib.php';
335
			dol_mkdir($dirodt);
336
			$result=dol_copy($src,$dest,0,0);
337
			if ($result < 0)
338
			{
339
				$langs->load("errors");
340
				$this->error=$langs->trans('ErrorFailToCopyFile',$src,$dest);
341
				return 0;
342
			}
343
		}
344
345
		$sql = array(
346
			 "DELETE FROM ".MAIN_DB_PREFIX."document_model WHERE nom = '".$this->const[0][2]."' AND type = 'project' AND entity = ".$conf->entity,
347
			 "INSERT INTO ".MAIN_DB_PREFIX."document_model (nom, type, entity) VALUES('".$this->const[0][2]."','project',".$conf->entity.")",
348
		);
349
350
		$sql = array(
351
			"DELETE FROM ".MAIN_DB_PREFIX."document_model WHERE nom = '".$this->const[3][2]."' AND type = 'task' AND entity = ".$conf->entity,
352
			"INSERT INTO ".MAIN_DB_PREFIX."document_model (nom, type, entity) VALUES('".$this->const[3][2]."','task',".$conf->entity.")"
353
		);
354
355
		return $this->_init($sql,$options);
356
	}
357
}
358