From e25c11d1c2be3e5222a46b482187f9b2b7c3e9c6 Mon Sep 17 00:00:00 2001 From: catch Date: Fri, 13 Jan 2023 09:42:59 +0000 Subject: [PATCH] Issue #3332712 by Liam Morland, DanielVeza: Cron links point to D7 documentation (cherry picked from commit 231e7718478686857118713765b241411a492050) --- core/INSTALL.txt | 7 ++++--- core/lib/Drupal/Core/CronInterface.php | 2 +- core/lib/Drupal/Core/Extension/module.api.php | 2 +- core/modules/system/system.install | 2 +- core/modules/system/system.module | 2 +- 5 files changed, 8 insertions(+), 7 deletions(-) diff --git a/core/INSTALL.txt b/core/INSTALL.txt index a75ba11a211..5219b6a7706 100644 --- a/core/INSTALL.txt +++ b/core/INSTALL.txt @@ -341,9 +341,10 @@ INSTALLATION page. More information about cron maintenance tasks is available at - https://www.drupal.org/cron, and sample cron shell scripts can be found in - the core/scripts/ directory. (Note that these scripts must be customized like - the above example, to add your site-specific cron key and domain name.) + https://www.drupal.org/docs/administering-a-drupal-site/cron-automated-tasks, + and sample cron shell scripts can be found in the core/scripts/ directory. + (Note that these scripts must be customized like the above example, to add + your site-specific cron key and domain name.) REINSTALL ------------ diff --git a/core/lib/Drupal/Core/CronInterface.php b/core/lib/Drupal/Core/CronInterface.php index 98c3f37c6b7..f638e628285 100644 --- a/core/lib/Drupal/Core/CronInterface.php +++ b/core/lib/Drupal/Core/CronInterface.php @@ -5,7 +5,7 @@ namespace Drupal\Core; /** * An interface for running cron tasks. * - * @see https://www.drupal.org/cron + * @see https://www.drupal.org/docs/administering-a-drupal-site/cron-automated-tasks */ interface CronInterface { diff --git a/core/lib/Drupal/Core/Extension/module.api.php b/core/lib/Drupal/Core/Extension/module.api.php index 7770b9e3bb2..f19b5ca667d 100644 --- a/core/lib/Drupal/Core/Extension/module.api.php +++ b/core/lib/Drupal/Core/Extension/module.api.php @@ -1008,7 +1008,7 @@ function hook_requirements($phase) { } else { $requirements['cron'] = [ - 'description' => t('Cron has not run. It appears cron jobs have not been setup on your system. Check the help pages for configuring cron jobs.', [':url' => 'https://www.drupal.org/cron']), + 'description' => t('Cron has not run. It appears cron jobs have not been setup on your system. Check the help pages for configuring cron jobs.', [':url' => 'https://www.drupal.org/docs/administering-a-drupal-site/cron-automated-tasks/cron-automated-tasks-overview']), 'severity' => REQUIREMENT_ERROR, 'value' => t('Never run'), ]; diff --git a/core/modules/system/system.install b/core/modules/system/system.install index 1f9fe3162f9..ae7e33b7c76 100644 --- a/core/modules/system/system.install +++ b/core/modules/system/system.install @@ -762,7 +762,7 @@ function system_requirements($phase) { '#suffix' => ' ', ], [ - '#markup' => t('For more information, see the online handbook entry for configuring cron jobs.', [':cron-handbook' => 'https://www.drupal.org/cron']), + '#markup' => t('For more information, see the online handbook entry for configuring cron jobs.', [':cron-handbook' => 'https://www.drupal.org/docs/administering-a-drupal-site/cron-automated-tasks/cron-automated-tasks-overview']), '#suffix' => ' ', ], ]; diff --git a/core/modules/system/system.module b/core/modules/system/system.module index 13f97debade..71d84e318a2 100644 --- a/core/modules/system/system.module +++ b/core/modules/system/system.module @@ -88,7 +88,7 @@ function system_help($route_name, RouteMatchInterface $route_match) { $output .= '
' . t('Configuring for performance') . '
'; $output .= '
' . t('On the Performance page, the site can be configured to aggregate CSS and JavaScript files, making the total request size smaller. Note that, for small- to medium-sized websites, the Internal Page Cache module should be installed so that pages are efficiently cached and reused for anonymous users. Finally, for websites of all sizes, the Dynamic Page Cache module should also be installed so that the non-personalized parts of pages are efficiently cached (for all users).', [':performance-page' => Url::fromRoute('system.performance_settings')->toString(), ':page-cache' => (\Drupal::moduleHandler()->moduleExists('page_cache')) ? Url::fromRoute('help.page', ['name' => 'page_cache'])->toString() : '#', ':dynamic-page-cache' => (\Drupal::moduleHandler()->moduleExists('dynamic_page_cache')) ? Url::fromRoute('help.page', ['name' => 'dynamic_page_cache'])->toString() : '#']) . '
'; $output .= '
' . t('Configuring cron') . '
'; - $output .= '
' . t('In order for the site and its modules to continue to operate well, a set of routine administrative operations must run on a regular basis; these operations are known as cron tasks. On the Cron page, you can configure cron to run periodically as part of server responses by installing the Automated Cron module, or you can turn this off and trigger cron from an outside process on your web server. You can verify the status of cron tasks by visiting the Status report page. For more information, see the online documentation for configuring cron jobs.', [':status' => Url::fromRoute('system.status')->toString(), ':handbook' => 'https://www.drupal.org/cron', ':cron' => Url::fromRoute('system.cron_settings')->toString()]) . '
'; + $output .= '
' . t('In order for the site and its modules to continue to operate well, a set of routine administrative operations must run on a regular basis; these operations are known as cron tasks. On the Cron page, you can configure cron to run periodically as part of server responses by installing the Automated Cron module, or you can turn this off and trigger cron from an outside process on your web server. You can verify the status of cron tasks by visiting the Status report page. For more information, see the online documentation for configuring cron jobs.', [':status' => Url::fromRoute('system.status')->toString(), ':handbook' => 'https://www.drupal.org/docs/administering-a-drupal-site/cron-automated-tasks/cron-automated-tasks-overview', ':cron' => Url::fromRoute('system.cron_settings')->toString()]) . '
'; $output .= '
' . t('Configuring the file system') . '
'; $output .= '
' . t('Your site has several file directories, which are used to store and process uploaded and generated files. The public file directory, which is configured in your settings.php file, is the default place for storing uploaded files. Links to files in this directory contain the direct file URL, so when the files are requested, the web server will send them directly without invoking your site code. This means that the files can be downloaded by anyone with the file URL, so requests are not access-controlled but they are efficient. The private file directory, also configured in your settings.php file and ideally located outside the site web root, is access controlled. Links to files in this directory are not direct, so requests to these files are mediated by your site code. This means that your site can check file access permission for each file before deciding to fulfill the request, so the requests are more secure, but less efficient. You should only use the private storage for files that need access control, not for files like your site logo and background images used on every page. The temporary file directory is used internally by your site code for various operations, and is configured on the File system settings page. You can also see the configured public and private file directories on this page, and choose whether public or private should be the default for uploaded files.', [':file-system' => Url::fromRoute('system.file_system_settings')->toString()]) . '
'; $output .= '
' . t('Configuring the image toolkit') . '
';