addItem( __('Maintenance'), 'plugin.php?p=maintenance', 'index.php?pf=maintenance/icon.png', preg_match('/plugin.php\?p=maintenance(&.*)?$/', $_SERVER['REQUEST_URI']), $core->auth->check('admin', $core->blog->id) ); // Admin behaviors $core->addBehavior('dcMaintenanceInit', array('dcMaintenanceAdmin', 'dcMaintenanceInit')); $core->addBehavior('adminDashboardFavs', array('dcMaintenanceAdmin', 'adminDashboardFavs')); $core->addBehavior('adminDashboardFavsIcon', array('dcMaintenanceAdmin', 'adminDashboardFavsIcon')); $core->addBehavior('adminDashboardContents', array('dcMaintenanceAdmin', 'adminDashboardItems')); $core->addBehavior('adminDashboardOptionsForm', array('dcMaintenanceAdmin', 'adminDashboardOptionsForm')); $core->addBehavior('adminAfterDashboardOptionsUpdate', array('dcMaintenanceAdmin', 'adminAfterDashboardOptionsUpdate')); $core->addBehavior('adminPageHelpBlock', array('dcMaintenanceAdmin', 'adminPageHelpBlock')); $core->addBehavior('pluginsToolsHeaders', array('dcMaintenanceAdmin', 'pluginsToolsHeaders')); /** @ingroup PLUGIN_MAINTENANCE @nosubgrouping @brief Maintenance plugin admin class. Group of methods used on behaviors. */ class dcMaintenanceAdmin { /** * Register default tasks. * * @param $maintenance dcMaintenance dcMaintenance instance */ public static function dcMaintenanceInit($maintenance) { $maintenance ->addTab('maintenance', __('Servicing'), array('summary' => __('Tools to maintain the performance of your blogs.'))) ->addTab('backup', __('Backup'), array('summary' => __('Tools to back up your content.'))) ->addTab('dev', __('Development'), array('summary' => __('Tools to assist in development of plugins, themes and core.'))) ->addGroup('optimize', __('Optimize')) ->addGroup('index', __('Count and index')) ->addGroup('purge', __('Purge')) ->addGroup('other', __('Other')) ->addGroup('zipblog', __('Current blog')) ->addGroup('zipfull', __('All blogs')) ->addGroup('l10n', __('Translations'), array('summary' => __('Maintain translations'))) ->addTask('dcMaintenanceCache') ->addTask('dcMaintenanceIndexposts') ->addTask('dcMaintenanceIndexcomments') ->addTask('dcMaintenanceCountcomments') ->addTask('dcMaintenanceSynchpostsmeta') ->addTask('dcMaintenanceLogs') ->addTask('dcMaintenanceVacuum') ->addTask('dcMaintenanceZipmedia') ->addTask('dcMaintenanceZiptheme') ; } /** * Dashboard favs. * * @param $core dcCore dcCore instance * @param $favs arrayObject Array of favs */ public static function adminDashboardFavs($core, $favs) { $favs['maintenance'] = new ArrayObject(array( 'maintenance', 'Maintenance', 'plugin.php?p=maintenance', 'index.php?pf=maintenance/icon.png', 'index.php?pf=maintenance/icon-big.png', null,null,null )); } /** * Dashboard favs icon. * * This updates maintenance fav icon text * if there are tasks required maintenance. * * @param $core dcCore dcCore instance * @param $name string Current fav name * @param $icon arrayObject Current fav attributes */ public static function adminDashboardFavsIcon($core, $name, $icon) { // Check icon if ($name !== 'maintenance') { return null; } // Check user option $core->auth->user_prefs->addWorkspace('maintenance'); if (!$core->auth->user_prefs->maintenance->dashboard_icon) { return null; } // Check expired tasks $maintenance = new dcMaintenance($core); $count = 0; foreach($maintenance->getTasks() as $t) { if ($t->expired() !== false){ $count++; } } if (!$count) { return null; } $icon[0] .= '
'.sprintf(__('One task to execute', '%s tasks to execute', $count), $count); $icon[2] = 'index.php?pf=maintenance/icon-big-update.png'; } /** * Dashboard items stack. * * @param $core dcCore dcCore instance * @param $items arrayObject Dashboard items */ public static function adminDashboardItems($core, $items) { $core->auth->user_prefs->addWorkspace('maintenance'); if (!$core->auth->user_prefs->maintenance->dashboard_item) { return null; } $maintenance = new dcMaintenance($core); $lines = array(); foreach($maintenance->getTasks() as $t) { $ts = $t->expired(); if ($ts === false){ continue; } $lines[] = '

'.$t->task().'

'; } if (empty($lines)) { return null; } $items[] = new ArrayObject(array( '

'. '

'.__('Maintenance').'

'. '

'.sprintf(__('There is a task to execute.', 'There are %s tasks to execute.', count($lines)), count($lines)).'

'. '

'.implode('',$lines).''. '

'.__('Manage tasks').'

'. '

' )); } /** * User preferences form. * * This add options for superadmin user * to show or not expired taks. * * @param $args object dcCore instance or record */ public static function adminDashboardOptionsForm($core) { $core->auth->user_prefs->addWorkspace('maintenance'); echo '

'. '

'.__('Maintenance').'

'. '

'. form::checkbox('maintenance_dashboard_icon', 1, $core->auth->user_prefs->maintenance->dashboard_icon). __('Display count of late tasks on maintenance dashboard icon').'

'. '

'. form::checkbox('maintenance_dashboard_item', 1, $core->auth->user_prefs->maintenance->dashboard_item). __('Display list of late tasks on dashboard items').'

'. '

'; } /** * User preferences update. * * @param $user_id string User ID */ public static function adminAfterDashboardOptionsUpdate($user_id=null) { global $core; if (is_null($user_id)) { return null; } $core->auth->user_prefs->addWorkspace('maintenance'); $core->auth->user_prefs->maintenance->put('dashboard_icon', !empty($_POST['maintenance_dashboard_icon']), 'boolean'); $core->auth->user_prefs->maintenance->put('dashboard_item', !empty($_POST['maintenance_dashboard_item']), 'boolean'); } /** * Build a well sorted help for tasks. * * This method is not so good if used with lot of tranlsations * as it grows memory usage and translations files size, * it is better to use help ressource files * but keep it for exemple of how to use behavior adminPageHelpBlock. * Cheers, JC * * @param $block arrayObject Called helpblocks */ public static function adminPageHelpBlock($blocks) { $found = false; foreach($blocks as $block) { if ($block == 'maintenancetasks') { $found = true; break; } } if (!$found) { return null; } $maintenance = new dcMaintenance($GLOBALS['core']); $res_tab = ''; foreach($maintenance->getTabs() as $tab_obj) { $res_group = ''; foreach($maintenance->getGroups() as $group_obj) { $res_task = ''; foreach($maintenance->getTasks() as $t) { if ($t->group() != $group_obj->id() || $t->tab() != $tab_obj->id()) { continue; } if (($desc = $t->description()) != '') { $res_task .= '

'.$t->task().'

'. '

'.$desc.'

'; } } if (!empty($res_task)) { $desc = $group_obj->description ? $group_obj->description : $group_obj->summary; $res_group .= '

'.$group_obj->name().'

'. ($desc ? '

'.$desc.'

' : ''). '

'.$res_task.''; } } if (!empty($res_group)) { $desc = $tab_obj->description ? $tab_obj->description : $tab_obj->summary; $res_tab .= '

'.$tab_obj->name().'

'. ($desc ? '

'.$desc.'

' : ''). $res_group; } } if (!empty($res_tab)) { $res = new ArrayObject(); $res->content = $res_tab; $blocks[] = $res; } } /** * Add javascript for plugin configuration. * * @param $core dcCore dcCore instance * @param $module mixed Module ID or false if none * @return string Header code for js inclusion */ public static function pluginsToolsHeaders($core, $module) { if ($module == 'maintenance') { return dcPage::jsLoad('index.php?pf=maintenance/js/settings.js'); } } }