dolibarr 24.0.0-beta
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-2025 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] = [
119 'fk_menu' => '0', // Use 'fk_mainmenu=xxx' or 'fk_mainmenu=xxx,fk_leftmenu=yyy' where xxx is mainmenucode and yyy is a leftmenucode
120 'type' => 'top', // This is a Left menu entry
121 'titre' => 'WebSites',
122 'prefix' => img_picto('', $this->picto, 'class="pictofixedwidth em092"'),
123 'mainmenu' => 'website',
124 'url' => '/website/index.php',
125 'langs' => 'website', // Lang file to use (without .lang) by module. File must be in langs/code_CODE/ directory.
126 'position' => 100,
127 'enabled' => 'isModEnabled("website")', // 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.
128 'perms' => '$user->hasRight("website","read")', // Use 'perms'=>'$user->hasRight("mymodule","level1","level2")' if you want your menu with a permission rules
129 'target' => '',
130 'user' => 2, // 0=Menu for internal users, 1=external users, 2=both
131 ];
132 $r++;
133
134 // Exports
135 $r = 1;
136
137 $this->export_code[$r] = $this->rights_class.'_'.$r;
138 $this->export_label[$r] = 'MyWebsitePages'; // Translation key (used only if key ExportDataset_xxx_z not found)
139 $this->export_permission[$r] = array(array("website", "export"));
140 $this->export_icon[$r] = 'globe';
141 $keyforclass = 'WebsitePage';
142 $keyforclassfile = '/website/class/websitepage.class.php';
143 $keyforelement = 'Website';
144 include DOL_DOCUMENT_ROOT.'/core/commonfieldsinexport.inc.php';
145 //$keyforselect='myobject'; $keyforelement='myobject'; $keyforaliasextra='extra';
146 //include DOL_DOCUMENT_ROOT.'/core/extrafieldsinexport.inc.php';
147 $this->export_sql_start[$r] = 'SELECT DISTINCT ';
148 $this->export_sql_end[$r] = ' FROM '.MAIN_DB_PREFIX.'website_page as t, '.MAIN_DB_PREFIX.'website as p';
149 $this->export_sql_end[$r] .= ' WHERE t.fk_website = p.rowid';
150 $this->export_sql_end[$r] .= ' AND p.entity IN ('.getEntity('website').')';
151 $r++;
152 }
153
154
163 public function init($options = '')
164 {
165 global $langs;
166
167 $error = 0;
168
169 $result = $this->_load_tables('/install/mysql/', 'website');
170 if ($result < 0) {
171 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')
172 }
173
174 // Remove permissions and default values
175 $this->remove($options);
176
177 // Copy flags directory
178 $dirarray = array('common/flags'=>'flags');
179 foreach ($dirarray as $dirfrom => $dirtarget) {
180 $src = DOL_DOCUMENT_ROOT.'/theme/'.$dirfrom;
181 $dest = DOL_DATA_ROOT.'/medias/image/'.$dirtarget;
182
183 if (is_dir($src)) {
184 require_once DOL_DOCUMENT_ROOT.'/core/lib/files.lib.php';
185 dol_mkdir($dest);
186 $result = dolCopyDir($src, $dest, '0', 0);
187 if ($result < 0) {
188 $langs->load("errors");
189 $this->error = $langs->trans('ErrorFailToCopyDir', $src, $dest);
190 $this->errors[] = $langs->trans('ErrorFailToCopyDir', $src, $dest);
191 $error++;
192 }
193 }
194 }
195
196 if ($error) {
197 return 0;
198 }
199
200 // Website templates
201 $srcroot = DOL_DOCUMENT_ROOT.'/install/doctemplates/websites';
202 $destroot = DOL_DATA_ROOT.'/doctemplates/websites';
203
204 dol_mkdir($destroot);
205
206 // Copy templates in zip format (old)
207 $docs = dol_dir_list($srcroot, 'files', 0, 'website_.*(\.zip|\.jpg)$');
208 foreach ($docs as $cursorfile) {
209 $src = $srcroot.'/'.$cursorfile['name'];
210 $dest = $destroot.'/'.$cursorfile['name'];
211
212 $result = dol_copy($src, $dest, '0', 1); // For full zip templates, we overwrite old existing files
213 if ($result < 0) {
214 $langs->load("errors");
215 $this->error = $langs->trans('ErrorFailToCopyFile', $src, $dest);
216 $this->errors[] = $langs->trans('ErrorFailToCopyFile', $src, $dest);
217 $error++;
218 }
219 }
220
221 // Copy templates in dir format (recommended) into zip file
222 $docs = dol_dir_list($srcroot, 'directories', 0, 'website_.*$');
223 foreach ($docs as $cursorfile) {
224 $src = $srcroot.'/'.$cursorfile['name'];
225 $dest = $destroot.'/'.$cursorfile['name'];
226
227 // Compress it
228 global $errormsg;
229 $errormsg = '';
230 $result = dol_compress_dir($src, $dest.'.zip', 'zip');
231 if ($result < 0) {
232 $error++;
233 $this->error = ($errormsg ? $errormsg : $langs->trans('ErrorFailToCreateZip', $dest));
234 $this->errors[] = ($errormsg ? $errormsg : $langs->trans('ErrorFailToCreateZip', $dest));
235 }
236 }
237
238 if ($error) {
239 return 0;
240 }
241
242 $sql = array();
243
244 return $this->_init($sql, $options);
245 }
246}
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:64
img_picto($titlealt, $picto, $moreatt='', $pictoisfullpath=0, $srconly=0, $notitle=0, $alt='', $morecss='', $marginleftonlyshort=2, $allowothertags=array())
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:133