27if (!defined(
'NOREQUIREMENU')) {
28 define(
'NOREQUIREMENU',
'1');
30if (!defined(
'NOTOKENRENEWAL')) {
31 define(
'NOTOKENRENEWAL',
'1');
36require
'../main.inc.php';
37require_once DOL_DOCUMENT_ROOT.
'/core/lib/admin.lib.php';
38require_once DOL_DOCUMENT_ROOT.
'/core/lib/files.lib.php';
39require_once DOL_DOCUMENT_ROOT.
'/core/lib/functions2.lib.php';
50$langs->loadLangs(array(
'errors',
'admin',
'modulebuilder',
'exports'));
52$mode =
GETPOST(
'mode',
'alpha');
53$action =
GETPOST(
'action',
'aZ09');
59if (empty($user->admin)) {
78$help_url =
'EN:First_setup|FR:Premiers_paramétrages|ES:Primeras_configuraciones';
79llxHeader(
'', $langs->trans(
"Setup"), $help_url,
'', 0, 0,
'',
'',
'',
'mod-admin page-modulehelp');
81print
'<!-- Force style container -->'.
"\n".
'<style>
90$arrayofnatures = array(
'core' => $langs->transnoentitiesnoconv(
"Core"),
'external' => $langs->transnoentitiesnoconv(
"External").
' - '.$langs->trans(
"AllPublishers"));
97'@phan-var-force DolibarrModules[] $modules';
104$modNameLoaded = array();
105$familyinfo = array();
107foreach ($modulesdir as $dir) {
110 dol_syslog(
"Scan directory ".$dir.
" for module descriptor files (modXXX.class.php)");
111 $handle = @opendir($dir);
112 if (is_resource($handle)) {
113 while (($file = readdir($handle)) !==
false) {
115 if (is_readable($dir.$file) && substr($file, 0, 3) ==
'mod' && substr($file,
dol_strlen($file) - 10) ==
'.class.php') {
116 $modName = substr($file, 0,
dol_strlen($file) - 10);
119 if (!empty($modNameLoaded[$modName])) {
120 $mesg =
"Error: Module ".$modName.
" was found twice: Into ".$modNameLoaded[$modName].
" and ".$dir.
". You probably have an old file on your disk.<br>";
127 $res = include_once $dir.$file;
128 if (class_exists($modName)) {
130 $objMod =
new $modName($db);
131 '@phan-var-force DolibarrModules $objMod';
132 $modNameLoaded[$modName] = $dir;
134 if (!$objMod->numero > 0 && $modName !=
'modUser') {
135 dol_syslog(
'The module descriptor '.$modName.
' must have a numero property', LOG_ERR);
137 $j = $objMod->numero;
139 $modulequalified = 1;
142 $const_name =
'MAIN_MODULE_'.strtoupper(preg_replace(
'/^mod/i',
'', get_class($objMod)));
144 $modulequalified = 0;
147 $modulequalified = 0;
150 $modulequalified = 0;
156 if ($modulequalified > 0) {
158 $external = ($objMod->isCoreOrExternalModule() ==
'external');
161 $arrayofnatures[
'external_'.$publisher] = $langs->trans(
"External").
' - '.$publisher;
163 $arrayofnatures[
'external_'] = $langs->trans(
"External").
' - '.$langs->trans(
"UnknownPublishers");
166 ksort($arrayofnatures);
170 if ($modulequalified > 0) {
171 $modules[$i] = $objMod;
172 $filename[$i] = $modName;
175 if (is_array($objMod->familyinfo) && !empty($objMod->familyinfo)) {
176 $familyinfo = array_merge($familyinfo, $objMod->familyinfo);
177 $familykey = key($objMod->familyinfo);
179 $familykey = $objMod->family;
181 if (empty($familykey) || $familykey ===
null) {
182 $familykey =
'other';
185 $moduleposition = ($objMod->module_position ? $objMod->module_position :
'50');
186 if ($moduleposition ==
'50' && ($objMod->isCoreOrExternalModule() ==
'external')) {
187 $moduleposition =
'80';
190 if (empty($familyinfo[$familykey][
'position'])) {
191 $familyinfo[$familykey][
'position'] =
'0';
194 $orders[$i] = $familyinfo[$familykey][
'position'].
"_".$familykey.
"_".$moduleposition.
"_".$j;
198 $specialstring =
'unknown';
199 if ($objMod->version ==
'development' || $objMod->version ==
'experimental') {
200 $specialstring =
'expdev';
202 if (isset($categ[$specialstring])) {
203 $categ[$specialstring]++;
205 $categ[$specialstring] = 1;
210 dol_syslog(
"Module ".get_class($objMod).
" not qualified");
213 dol_syslog(
"Failed to load ".$dir.$file.
" ".$e->getMessage(), LOG_ERR);
216 print
info_admin(
"Warning bad descriptor file : ".$dir.$file.
" (Class ".$modName.
" not found into file)", 0, 0,
'1',
'warning');
219 dol_syslog(
"Failed to load ".$dir.$file.
" ".$e->getMessage(), LOG_ERR);
226 dol_syslog(
"htdocs/admin/modulehelp.php: Failed to open directory ".$dir.
". See permission and open_basedir option.", LOG_WARNING);
240foreach ($orders as $tmpkey => $tmpvalue) {
241 $tmpMod = $modules[$tmpkey];
242 '@phan-var-force DolibarrModules $tmpMod';
243 if ($tmpMod->numero == $id) {
245 $modName = $filename[$tmpkey];
246 $dirofmodule = $dirmod[$tmpkey];
252if (!is_object($objMod)) {
253 $msg = __FILE__.
" Module with no found for id:".
$id;
258$value = $orders[$key];
259$tab = explode(
'_', $value);
260$familyposition = $tab[0];
262$module_position = $tab[2];
270$modulename = $objMod->getName();
271$moduledesc = $objMod->getDesc();
272$moduleauthor = $objMod->getPublisher();
273$moduledir = strtolower(preg_replace(
'/^mod/i',
'', get_class($objMod)));
275$const_name =
'MAIN_MODULE_'.strtoupper(preg_replace(
'/^mod/i',
'', get_class($objMod)));
277$text =
'<span class="opacitymedium">'.$langs->trans(
"LastActivationDate").
':</span> ';
279 $text .=
dol_print_date($objMod->getLastActivationDate(),
'dayhour');
281 $text .= $langs->trans(
"Disabled");
283$tmp = $objMod->getLastActivationInfo();
284$authorid = (empty($tmp[
'authorid']) ?
'' : $tmp[
'authorid']);
286 $tmpuser =
new User($db);
287 $tmpuser->fetch($authorid);
288 $text .=
'<br><span class="opacitymedium">'.$langs->trans(
"LastActivationAuthor").
':</span> ';
289 $text .= $tmpuser->getNomUrl(-1);
291$ip = (empty($tmp[
'ip']) ?
'' : $tmp[
'ip']);
293 $text .=
'<br><span class="opacitymedium">'.$langs->trans(
"LastActivationIP").
':</span> ';
296$lastactivationversion = (empty($tmp[
'lastactivationversion']) ?
'' : $tmp[
'lastactivationversion']);
297if ($lastactivationversion) {
298 $text .=
'<br><span class="opacitymedium">'.$langs->trans(
"LastActivationVersion").
':</span> ';
299 $text .= $lastactivationversion;
304$title = ($modulename ? $modulename : $moduledesc);
306print
'<div class="centpercent">';
308$picto =
'object_'.$objMod->picto;
310print
load_fiche_titre(($modulename ? $modulename : $moduledesc), $moreinfo, $picto, 0,
'',
'titlemodulehelp');
316 dol_syslog(
"Error for module ".$key.
" - Property name of module looks empty", LOG_WARNING);
320if (isset($objMod->langfiles) && is_array($objMod->langfiles)) {
321 foreach ($objMod->langfiles as $domain) {
322 $langs->load($domain);
330$version = $objMod->getVersion(0);
332if (preg_match(
'/development/i', $version)) {
333 $versiontrans .=
img_warning($langs->trans(
"Development"),
'style="float: left"');
335if (preg_match(
'/experimental/i', $version)) {
336 $versiontrans .=
img_warning($langs->trans(
"Experimental"),
'style="float: left"');
338if (preg_match(
'/deprecated/i', $version)) {
339 $versiontrans .=
img_warning($langs->trans(
"Deprecated"),
'style="float: left"');
341$versiontrans .= $objMod->getVersion(1);
345if ($objMod->isCoreOrExternalModule() ==
'external') {
346 $imginfo =
"info_black";
352if ($mode ==
'desc') {
354 $text .=
'<br>'.$moduledesc.
'<br><br><br>';
357 $moduledescriptorfile = get_class($objMod).
'.class.php';
358 $text .=
'<span class="opacitymedium">'.$langs->trans(
"DescriptorFile").
':</span> '.$moduledescriptorfile;
360 $text .=
'<br><span class="opacitymedium">'.$langs->trans(
"IdModule").
':</span> '.$objMod->numero;
363 if ($objMod->isCoreOrExternalModule() ==
'external') {
364 $tmpdirofmoduletoshow = preg_replace(
'/^'.preg_quote(DOL_DOCUMENT_ROOT,
'/').
'/',
'', (
string) $dirofmodule);
365 $textexternal .=
'<br><span class="opacitymedium">'.$langs->trans(
"Origin").
':</span> '.$langs->trans(
"ExternalModule").
' - '.$langs->trans(
"InstalledInto", $tmpdirofmoduletoshow);
367 global $dolibarr_allow_download_external_modules;
368 if (!empty($dolibarr_allow_download_external_modules) && preg_match(
'/\/custom\//', (
string) $dirofmodule)) {
370 $textexternal .=
' <a href="'.DOL_URL_ROOT.
'/admin/tools/export_files.php?export_type=externalmodule&what='.urlencode($moduledir).
'&compression=zip&zipfilename_template=module_'.$moduledir.
'-'.$version.
'.notorig" target="_blank" rel="noopener">'.
img_picto(
'',
'download').
'</a>';
373 if ($objMod->editor_name !=
'dolibarr') {
374 $textexternal .=
'<br><span class="opacitymedium">'.$langs->trans(
"Publisher").
':</span> '.(empty($objMod->editor_name) ? $langs->trans(
"Unknown") : $objMod->editor_name);
376 $editor_url = $objMod->editor_url;
377 if (!preg_match(
'/^http/', $editor_url)) {
378 $editor_url =
'http://'.$editor_url;
380 if (!empty($objMod->editor_url) && !preg_match(
'/dolibarr\.org/i', $objMod->editor_url)) {
381 $textexternal .= ($objMod->editor_name !=
'dolibarr' ?
' - ' :
'').
img_picto(
'',
'globe').
' <a href="'.$editor_url.
'" target="_blank" rel="noopener noreferrer external">'.$objMod->editor_url.
'</a>';
383 $text .= $textexternal;
385 $text .=
'<br><span class="opacitymedium">'.$langs->trans(
"Origin").
':</span> '.$langs->trans(
"Core");
386 if (empty($objMod->numero)) {
387 $text .=
' <span class="italic opacitymedium">('.$langs->trans(
"AlwaysEnabled").
')</span>';
388 } elseif (!empty($objMod->enabled_bydefault)) {
389 $text .=
' <span class="italic opacitymedium">('.$langs->trans(
"EnabledByDefaultAtInstall").
')</span>';
393 $text .=
'<br><span class="opacitymedium">'.$langs->trans(
"Version").
':</span> '.$version;
397 $moduledesclong = $objMod->getDescLong();
398 if ($moduledesclong) {
399 $text .=
'<br><hr><div class="moduledesclong">'.$moduledesclong.
'<div>';
403if ($mode ==
'feature') {
404 $text .=
'<br><strong>'.$langs->trans(
"DependsOn").
':</strong> ';
405 if (is_array($objMod->depends) && count($objMod->depends)) {
407 foreach ($objMod->depends as $modulestringorarray) {
408 if (is_array($modulestringorarray)) {
409 $text .= ($i ?
', ' :
'').implode(
', ', $modulestringorarray);
411 $text .= ($i ?
', ' :
'').$modulestringorarray;
416 $text .=
'<span class="opacitymedium">'.$langs->trans(
"None").
'</span>';
420 $text .=
'<br><strong>'.$langs->trans(
"RequiredBy").
':</strong> ';
421 if (is_array($objMod->requiredby) && count($objMod->requiredby)) {
423 foreach ($objMod->requiredby as $modulestringorarray) {
424 if (is_array($modulestringorarray)) {
425 $text .= ($i ?
', ' :
'').implode(
', ', $modulestringorarray);
427 $text .= ($i ?
', ' :
'').$modulestringorarray;
432 $text .=
'<span class="opacitymedium">'.$langs->trans(
"None").
'</span>';
437 $text .=
'<br><strong>'.$langs->trans(
"AddDataTables").
':</strong> ';
438 $listofsqlfiles1 =
dol_dir_list(DOL_DOCUMENT_ROOT.
'/install/mysql/tables/',
'files', 0,
'llx.*-'.$moduledir.
'\.sql', array(
'\.key\.sql',
'\.sql\.back'));
439 $listofsqlfiles2 =
dol_dir_list(
dol_buildpath($moduledir.
'/sql/'),
'files', 0,
'llx.*\.sql', array(
'\.key\.sql',
'\.sql\.back'));
440 $sqlfiles = array_merge($listofsqlfiles1, $listofsqlfiles2);
442 if (count($sqlfiles) > 0) {
444 foreach ($sqlfiles as $val) {
445 $text .= ($i ?
', ' :
'').preg_replace(
'/\-'.$moduledir.
'$/',
'', preg_replace(
'/\.sql$/',
'', preg_replace(
'/llx_/',
'', $val[
'name'])));
449 $text .=
'<span class="opacitymedium">'.$langs->trans(
"No").
'</span>';
454 $text .=
'<br><strong>'.$langs->trans(
"AddDictionaries").
':</strong> ';
455 if (isset($objMod->dictionaries) && isset($objMod->dictionaries[
'tablib']) && is_array($objMod->dictionaries[
'tablib']) && count($objMod->dictionaries[
'tablib'])) {
457 foreach ($objMod->dictionaries[
'tablib'] as $val) {
458 $text .= ($i ?
', ' :
'').$val;
462 $text .=
'<span class="opacitymedium">'.$langs->trans(
"No").
'</span>';
467 $text .=
'<br><strong>'.$langs->trans(
"AddData").
':</strong> ';
470 $text .= $langs->trans(
"Yes").
' <span class="opacitymedium">('.$moduledir.
'/sql/data.sql)</span>';
472 $text .=
'<span class="opacitymedium">'.$langs->trans(
"No").
'</span>';
477 $text .=
'<br><strong>'.$langs->trans(
"AddRemoveTabs").
':</strong> ';
478 if (isset($objMod->tabs) && is_array($objMod->tabs) && count($objMod->tabs)) {
480 foreach ($objMod->tabs as $val) {
481 if (is_array($val)) {
484 if (is_string($val)) {
485 $tmp = explode(
':', $val, 3);
486 $text .= ($i ?
', ' :
'').$tmp[0].
':'.$tmp[1];
491 $text .=
'<span class="opacitymedium">'.$langs->trans(
"No").
'</span>';
496 $text .=
'<br><strong>'.$langs->trans(
"AddModels").
':</strong> ';
497 if (isset($objMod->module_parts) && isset($objMod->module_parts[
'models']) && $objMod->module_parts[
'models']) {
498 $text .= $langs->trans(
"Yes");
500 $text .=
'<span class="opacitymedium">'.$langs->trans(
"No").
'</span>';
505 $text .=
'<br><strong>'.$langs->trans(
"AddSubstitutions").
':</strong> ';
506 if (isset($objMod->module_parts) && isset($objMod->module_parts[
'substitutions']) && $objMod->module_parts[
'substitutions']) {
507 $text .= $langs->trans(
"Yes");
509 $text .=
'<span class="opacitymedium">'.$langs->trans(
"No").
'</span>';
514 $text .=
'<br><strong>'.$langs->trans(
"AddSheduledJobs").
':</strong> ';
515 if (isset($objMod->cronjobs) && is_array($objMod->cronjobs) && count($objMod->cronjobs)) {
517 foreach ($objMod->cronjobs as $val) {
518 $text .= ($i ?
', ' :
'').($val[
'label']);
522 $text .=
'<span class="opacitymedium">'.$langs->trans(
"No").
'</span>';
527 $text .=
'<br><strong>'.$langs->trans(
"AddTriggers").
':</strong> ';
528 $moreinfoontriggerfile =
'';
529 if (isset($objMod->module_parts) && isset($objMod->module_parts[
'triggers']) && $objMod->module_parts[
'triggers']) {
532 $yesno =
'<span class="opacitymedium">'.$langs->trans(
"No").
'</span>';
534 require_once DOL_DOCUMENT_ROOT.
'/core/class/interfaces.class.php';
536 $triggers = $interfaces->getTriggersList(array((($objMod->isCoreOrExternalModule() ==
'external') ?
'/'.$moduledir :
'').
'/core/triggers'));
537 foreach ($triggers as $triggercursor) {
538 if ($triggercursor[
'module'] == $moduledir) {
540 $moreinfoontriggerfile =
' ('.$triggercursor[
'relpath'].
')';
544 $text .= $langs->trans($yesno).$moreinfoontriggerfile;
548 $text .=
'<br><strong>'.$langs->trans(
"AddBoxes").
':</strong> ';
549 if (isset($objMod->boxes) && is_array($objMod->boxes) && count($objMod->boxes)) {
551 foreach ($objMod->boxes as $val) {
552 $boxstring = (empty($val[
'file']) ? (empty($val[0]) ?
'' : $val[0]) : $val[
'file']);
554 $text .= ($i ?
', ' :
'').$boxstring;
559 $text .=
'<span class="opacitymedium">'.$langs->trans(
"No").
'</span>';
564 $text .=
'<br><strong>'.$langs->trans(
"AddHooks").
':</strong> ';
565 if (isset($objMod->module_parts) && isset($objMod->module_parts[
'hooks']) && is_array($objMod->module_parts[
'hooks']) && count($objMod->module_parts[
'hooks'])) {
567 foreach ($objMod->module_parts[
'hooks'] as $key => $val) {
568 if ($key ===
'entity') {
573 if ($key ===
'data') {
574 if (is_array($val)) {
575 foreach ($val as $value) {
576 $text .= ($i ?
', ' :
'').($value);
584 $text .= ($i ?
', ' :
'').($val);
588 $text .=
'<span class="opacitymedium">'.$langs->trans(
"No").
'</span>';
593 $text .=
'<br><strong>'.$langs->trans(
"AddPermissions").
':</strong> ';
594 if (isset($objMod->rights) && is_array($objMod->rights) && count($objMod->rights)) {
596 foreach ($objMod->rights as $val) {
597 $text .= ($i ?
', ' :
'').($val[1]);
601 $text .=
'<span class="opacitymedium">'.$langs->trans(
"No").
'</span>';
606 $text .=
'<br><strong>'.$langs->trans(
"AddMenus").
':</strong> ';
607 if (isset($objMod->menu) && !empty($objMod->menu)) {
608 $text .= $langs->trans(
"Yes");
610 $text .=
'<span class="opacitymedium">'.$langs->trans(
"No").
'</span>';
615 $text .=
'<br><strong>'.$langs->trans(
"AddExportProfiles").
':</strong> ';
616 if (isset($objMod->export_label) && is_array($objMod->export_label) && count($objMod->export_label)) {
618 foreach ($objMod->export_label as $val) {
619 $text .= ($i ?
', ' :
'').($val);
623 $text .=
'<span class="opacitymedium">'.$langs->trans(
"No").
'</span>';
628 $text .=
'<br><strong>'.$langs->trans(
"AddImportProfiles").
':</strong> ';
629 if (isset($objMod->import_label) && is_array($objMod->import_label) && count($objMod->import_label)) {
631 foreach ($objMod->import_label as $val) {
632 $text .= ($i ?
', ' :
'').($val);
636 $text .=
'<span class="opacitymedium">'.$langs->trans(
"No").
'</span>';
641 $text .=
'<br><strong>'.$langs->trans(
"AddWebsiteTemplates").
':</strong> ';
642 if (isset($objMod->module_parts) && isset($objMod->module_parts[
'websitetemplates']) && $objMod->module_parts[
'websitetemplates']) {
643 $text .= $langs->trans(
"Yes");
645 $text .=
'<span class="opacitymedium">'.$langs->trans(
"No").
'</span>';
650 $text .=
'<br><strong>'.$langs->trans(
"AddOtherPagesOrServices").
':</strong> ';
651 $text .=
'<span class="opacitymedium">'.$langs->trans(
"DetectionNotPossible").
'</span>';
655if ($mode ==
'changelog') {
656 $changelog = $objMod->getChangeLog();
658 $text .=
'<div class="moduledesclong">'.$changelog.
'<div>';
660 $text .=
'<div class="moduledesclong"><span class="opacitymedium">'.$langs->trans(
"NotAvailable").
'</span></div>';
modulehelp_prepare_head($object)
Prepare array with list of tabs.
if(!defined('NOREQUIRESOC')) if(!defined( 'NOREQUIRETRAN')) if(!defined('NOTOKENRENEWAL')) if(!defined( 'NOREQUIREMENU')) if(!defined('NOREQUIREHTML')) if(!defined( 'NOREQUIREAJAX')) llxHeader($head='', $title='', $help_url='', $target='', $disablejs=0, $disablehead=0, $arrayofjs='', $arrayofcss='', $morequerystring='', $morecssonbody='', $replacemainareaby='', $disablenofollow=0, $disablenoindex=0)
Empty header.
Class to manage triggers.
Class to manage Dolibarr users.
dol_is_file($pathoffile)
Return if path is a file.
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.
dolGetModulesDirs($subdir='')
Return list of directories that contain modules.
load_fiche_titre($title, $morehtmlright='', $picto='generic', $pictoisfullpath=0, $id='', $morecssontable='', $morehtmlcenter='')
Load a title with picto.
setEventMessages($mesg, $mesgs, $style='mesgs', $messagekey='', $noduplicate=0, $attop=0)
Set event messages in dol_events session object.
img_warning($titlealt='default', $moreatt='', $morecss='pictowarning')
Show warning logo.
img_picto($titlealt, $picto, $moreatt='', $pictoisfullpath=0, $srconly=0, $notitle=0, $alt='', $morecss='', $marginleftonlyshort=2)
Show picto whatever it's its name (generic function)
GETPOSTINT($paramname, $method=0)
Return the value of a $_GET or $_POST supervariable, converted into integer.
dol_get_fiche_head($links=array(), $active='', $title='', $notab=0, $picto='', $pictoisfullpath=0, $morehtmlright='', $morecss='', $limittoshow=0, $moretabssuffix='', $dragdropfile=0)
Show tabs of a record.
dol_get_fiche_end($notab=0)
Return tab footer of a card.
dol_strlen($string, $stringencoding='UTF-8')
Make a strlen call.
getDolGlobalInt($key, $default=0)
Return a Dolibarr global constant int value.
dol_print_date($time, $format='', $tzoutput='auto', $outputlangs=null, $encodetooutput=false)
Output date in a string format according to outputlangs (or langs if not defined).
GETPOST($paramname, $check='alphanohtml', $method=0, $filter=null, $options=null, $noreplace=0)
Return value of a param into GET or POST supervariable.
dol_buildpath($path, $type=0, $returnemptyifnotfound=0)
Return path of url or filesystem.
getDolGlobalString($key, $default='')
Return a Dolibarr global constant string value.
info_admin($text, $infoonimgalt=0, $nodiv=0, $admin='1', $morecss='hideonsmartphone', $textfordropdown='', $picto='')
Show information in HTML for admin users or standard users.
dol_syslog($message, $level=LOG_INFO, $ident=0, $suffixinfilename='', $restricttologhandler='', $logcontext=null)
Write log message into outputs.
dol_escape_htmltag($stringtoescape, $keepb=0, $keepn=0, $noescapetags='', $escapeonlyhtmltags=0, $cleanalsojavascript=0)
Returns text escaped for inclusion in HTML alt or title or value tags, or into values of HTML input f...
accessforbidden($message='', $printheader=1, $printfooter=1, $showonlymessage=0, $params=null)
Show a message to say access is forbidden and stop program.