dolibarr 21.0.0-alpha
modWebsite.class.php
Go to the documentation of this file.
1<?php
2/* Copyright (C) 2015 Laurent Destailleur <eldy@users.sourceforge.net>
3 * Copyright (C) 2024 Frédéric France <frederic.france@free.fr>
4 *
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 3 of the License, or
8 * (at your option) any later version.
9 *
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
14 *
15 * You should have received a copy of the GNU General Public License
16 * along with this program. If not, see <https://www.gnu.org/licenses/>.
17 */
18
26include_once DOL_DOCUMENT_ROOT.'/core/modules/DolibarrModules.class.php';
27
28
33{
39 public function __construct($db)
40 {
41 $this->db = $db;
42 $this->numero = 10000;
43
44 // Family can be 'crm','financial','hr','projects','products','ecm','technic','other'
45 // It is used to group modules in module setup page
46 $this->family = "portal";
47 $this->module_position = '50';
48 // Module label (no space allowed), used if translation string 'ModuleXXXName' not found (where XXX is value of numeric property 'numero' of module)
49 $this->name = preg_replace('/^mod/i', '', get_class($this));
50 $this->description = "Enable to build and serve public web sites with CMS features";
51 // Possible values for version are: 'development', 'experimental', 'dolibarr' or version
52 $this->version = 'dolibarr';
53 // Key used in llx_const table to save module status enabled/disabled (where MYMODULE is value of property name of module in uppercase)
54 $this->const_name = 'MAIN_MODULE_'.strtoupper($this->name);
55 // Name of image file used for this module.
56 $this->picto = 'website';
57
58 // Data directories to create when module is enabled
59 $this->dirs = array("/website/temp");
60
61 // Config pages
62 $this->config_page_url = array('website.php');
63
64 // Dependencies
65 $this->hidden = getDolGlobalInt('MODULE_WEBSITE_DISABLED'); // A condition to disable module
66 $this->depends = array('modFckeditor'); // List of modules id that must be enabled if this module is enabled
67 $this->requiredby = array(); // List of modules id to disable if this one is disabled
68 $this->conflictwith = array(); // List of modules id this module is in conflict with
69 $this->phpmin = array(7, 0); // Minimum version of PHP required by module
70 $this->langfiles = array("website");
71
72 // Constants
73 $this->const = array();
74
75 // New pages on tabs
76 //$this->tabs[] = array(); // To add a new tab identified by code tabname1
77
78 // Boxes
79 $this->boxes = array();
80
81 // Permissions
82 $this->rights = array(); // Permission array used by this module
83 $this->rights_class = 'website';
84 $r = 0;
85
86 $this->rights[$r][0] = 10001;
87 $this->rights[$r][1] = 'Read website content';
88 $this->rights[$r][3] = 0;
89 $this->rights[$r][4] = 'read';
90 $r++;
91
92 $this->rights[$r][0] = 10002;
93 $this->rights[$r][1] = 'Create/modify website content (html and javascript content)';
94 $this->rights[$r][3] = 0;
95 $this->rights[$r][4] = 'write';
96 $r++;
97
98 $this->rights[$r][0] = 10003;
99 $this->rights[$r][1] = 'Create/modify website content (dynamic php code). Dangerous, must be reserved to restricted developers.';
100 $this->rights[$r][3] = 0;
101 $this->rights[$r][4] = 'writephp';
102 $r++;
103
104 $this->rights[$r][0] = 10005;
105 $this->rights[$r][1] = 'Delete website content';
106 $this->rights[$r][3] = 0;
107 $this->rights[$r][4] = 'delete';
108 $r++;
109
110 $this->rights[$r][0] = 10008;
111 $this->rights[$r][1] = 'Export website content';
112 $this->rights[$r][3] = 0;
113 $this->rights[$r][4] = 'export';
114 $r++;
115
116 // Main menu entries
117 $r = 0;
118 $this->menu[$r] = array('fk_menu'=>'0', // Use 'fk_mainmenu=xxx' or 'fk_mainmenu=xxx,fk_leftmenu=yyy' where xxx is mainmenucode and yyy is a leftmenucode
119 'type'=>'top', // This is a Left menu entry
120 'titre'=>'WebSites',
121 'prefix' => img_picto('', $this->picto, 'class="pictofixedwidth em092"'),
122 'mainmenu'=>'website',
123 'url'=>'/website/index.php',
124 'langs'=>'website', // Lang file to use (without .lang) by module. File must be in langs/code_CODE/ directory.
125 'position'=>100,
126 'enabled'=>'$conf->website->enabled', // Define condition to show or hide menu entry. Use '$conf->mymodule->enabled' if entry must be visible if module is enabled. Use '$leftmenu==\'system\'' to show if leftmenu system is selected.
127 'perms'=>'$user->rights->website->read', // Use 'perms'=>'$user->hasRight("mymodule","level1","level2")' if you want your menu with a permission rules
128 'target'=>'',
129 'user'=>2); // 0=Menu for internal users, 1=external users, 2=both
130 $r++;
131
132 // Exports
133 $r = 1;
134
135 $this->export_code[$r] = $this->rights_class.'_'.$r;
136 $this->export_label[$r] = 'MyWebsitePages'; // Translation key (used only if key ExportDataset_xxx_z not found)
137 $this->export_permission[$r] = array(array("website", "export"));
138 $this->export_icon[$r] = 'globe';
139 $keyforclass = 'WebsitePage';
140 $keyforclassfile = '/website/class/websitepage.class.php';
141 $keyforelement = 'Website';
142 include DOL_DOCUMENT_ROOT.'/core/commonfieldsinexport.inc.php';
143 //$keyforselect='myobject'; $keyforelement='myobject'; $keyforaliasextra='extra';
144 //include DOL_DOCUMENT_ROOT.'/core/extrafieldsinexport.inc.php';
145 $this->export_sql_start[$r] = 'SELECT DISTINCT ';
146 $this->export_sql_end[$r] = ' FROM '.MAIN_DB_PREFIX.'website_page as t, '.MAIN_DB_PREFIX.'website as p';
147 $this->export_sql_end[$r] .= ' WHERE t.fk_website = p.rowid';
148 $this->export_sql_end[$r] .= ' AND p.entity IN ('.getEntity('website').')';
149 $r++;
150 }
151
152
161 public function init($options = '')
162 {
163 global $langs;
164
165 $error = 0;
166
167 $result = $this->_load_tables('/install/mysql/', 'website');
168 if ($result < 0) {
169 return -1; // Do not activate module if error 'not allowed' returned when loading module SQL queries (the _load_table run sql with run_sql with the error allowed parameter set to 'default')
170 }
171
172 // Remove permissions and default values
173 $this->remove($options);
174
175 // Copy flags and octicons directory
176 $dirarray = array('common/flags'=>'flags', 'common/octicons/build/svg'=>'octicons');
177 foreach ($dirarray as $dirfrom => $dirtarget) {
178 $src = DOL_DOCUMENT_ROOT.'/theme/'.$dirfrom;
179 $dest = DOL_DATA_ROOT.'/medias/image/'.$dirtarget;
180
181 if (is_dir($src)) {
182 require_once DOL_DOCUMENT_ROOT.'/core/lib/files.lib.php';
183 dol_mkdir($dest);
184 $result = dolCopyDir($src, $dest, '0', 0);
185 if ($result < 0) {
186 $langs->load("errors");
187 $this->error = $langs->trans('ErrorFailToCopyDir', $src, $dest);
188 $this->errors[] = $langs->trans('ErrorFailToCopyDir', $src, $dest);
189 $error++;
190 }
191 }
192 }
193
194 if ($error) {
195 return 0;
196 }
197
198 // Website templates
199 $srcroot = DOL_DOCUMENT_ROOT.'/install/doctemplates/websites';
200 $destroot = DOL_DATA_ROOT.'/doctemplates/websites';
201
202 dol_mkdir($destroot);
203
204 // Copy templates in zip format (old)
205 $docs = dol_dir_list($srcroot, 'files', 0, 'website_.*(\.zip|\.jpg)$');
206 foreach ($docs as $cursorfile) {
207 $src = $srcroot.'/'.$cursorfile['name'];
208 $dest = $destroot.'/'.$cursorfile['name'];
209
210 $result = dol_copy($src, $dest, '0', 1); // For full zip templates, we overwrite old existing files
211 if ($result < 0) {
212 $langs->load("errors");
213 $this->error = $langs->trans('ErrorFailToCopyFile', $src, $dest);
214 $this->errors[] = $langs->trans('ErrorFailToCopyFile', $src, $dest);
215 $error++;
216 }
217 }
218
219 // Copy templates in dir format (recommended) into zip file
220 $docs = dol_dir_list($srcroot, 'directories', 0, 'website_.*$');
221 foreach ($docs as $cursorfile) {
222 $src = $srcroot.'/'.$cursorfile['name'];
223 $dest = $destroot.'/'.$cursorfile['name'];
224
225 // Compress it
226 global $errormsg;
227 $errormsg = '';
228 $result = dol_compress_dir($src, $dest.'.zip', 'zip');
229 if ($result < 0) {
230 $error++;
231 $this->error = ($errormsg ? $errormsg : $langs->trans('ErrorFailToCreateZip', $dest));
232 $this->errors[] = ($errormsg ? $errormsg : $langs->trans('ErrorFailToCreateZip', $dest));
233 }
234 }
235
236 if ($error) {
237 return 0;
238 }
239
240 $sql = array();
241
242 return $this->_init($sql, $options);
243 }
244}
Class DolibarrModules.
_init($array_sql, $options='')
Enables a module.
_load_tables($reldir, $onlywithsuffix='')
Create tables and keys required by module:
Class to describe Websites module.
__construct($db)
Constructor.
init($options='')
Function called when module is enabled.
print $script_file $mode $langs defaultlang(is_numeric($duration_value) ? " delay=". $duration_value :"").(is_numeric($duration_value2) ? " after cd cd cd description as description
Only used if Module[ID]Desc translation string is not found.
dol_copy($srcfile, $destfile, $newmask='0', $overwriteifexists=1, $testvirus=0, $indexdatabase=0)
Copy a file to another file.
dolCopyDir($srcfile, $destfile, $newmask, $overwriteifexists, $arrayreplacement=null, $excludesubdir=0, $excludefileext=null, $excludearchivefiles=0)
Copy a dir to another dir.
dol_dir_list($utf8_path, $types="all", $recursive=0, $filter="", $excludefilter=null, $sortcriteria="name", $sortorder=SORT_ASC, $mode=0, $nohook=0, $relativename="", $donotfollowsymlinks=0, $nbsecondsold=0)
Scan a directory and return a list of files/directories.
Definition files.lib.php:63
img_picto($titlealt, $picto, $moreatt='', $pictoisfullpath=0, $srconly=0, $notitle=0, $alt='', $morecss='', $marginleftonlyshort=2)
Show picto whatever it's its name (generic function)
getDolGlobalInt($key, $default=0)
Return a Dolibarr global constant int value.
dol_mkdir($dir, $dataroot='', $newmask='')
Creation of a directory (this can create recursive subdir)
$conf db name
Only used if Module[ID]Name translation string is not found.
Definition repair.php:140