[TASK] Deprecate script-based modules
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Classes / Utility / ExtensionManagementUtility.php
index f3423ce..7479567 100644 (file)
@@ -901,7 +901,7 @@ class ExtensionManagementUtility
      * @param string $main The main module key, $sub is the submodule key. So $main would be an index in the $TBE_MODULES array and $sub could be an element in the lists there.
      * @param string $sub The submodule key. If $sub is not set a blank $main module is created.
      * @param string $position Can be used to set the position of the $sub module within the list of existing submodules for the main module. $position has this syntax: [cmd]:[submodule-key]. cmd can be "after", "before" or "top" (or blank which is default). If "after"/"before" then submodule will be inserted after/before the existing submodule with [submodule-key] if found. If not found, the bottom of list. If "top" the module is inserted in the top of the submodule list.
-     * @param string $path The absolute path to the module. If this value is defined the path is added as an entry in $TBE_MODULES['_PATHS'][  main_sub  ] = $path; and thereby tells the backend where the newly added modules is found in the system.
+     * @param string $path The absolute path to the module. If this value is defined the path is added as an entry in $TBE_MODULES['_PATHS'][  main_sub  ] = $path; and thereby tells the backend where the newly added modules is found in the system. This option is deprecated as of TYPO3 CMS 7, and will have no effect in TYPO3 CMS 8 anymore.
      * @param array $moduleConfiguration additional configuration, previously put in "conf.php" of the module directory
      * @return void
      */
@@ -941,6 +941,7 @@ class ExtensionManagementUtility
         $fullModuleSignature = $main . ($sub ? '_' . $sub : '');
         // Adding path:
         if ($path) {
+            GeneralUtility::deprecationLog('Registered "' . $fullModuleSignature . '" as a script-based module. Script-based modules are deprecated since TYPO3 CMS 7. Support will be removed with TYPO3 CMS 8, use the "routeTarget" option or dispatched modules instead.');
             self::addModulePath($fullModuleSignature, $path);
         }
 
@@ -993,9 +994,11 @@ class ExtensionManagementUtility
      * @param string $name The name of the module, refer to conf.php of the module.
      * @param string $path The absolute path to the module directory inside of which "index.php" and "conf.php" is found.
      * @return void
+     * @deprecated since TYPO3 CMS 7, will be removed in TYPO3 CMS 8, use routeTarget or dispatched modules instead.
      */
     public static function addModulePath($name, $path)
     {
+        GeneralUtility::logDeprecatedFunction();
         if (StringUtility::beginsWith($path, 'EXT:')) {
             list($extensionKey, $relativePath) = explode('/', substr($path, 4), 2);
             $path = ExtensionManagementUtility::extPath($extensionKey) . $relativePath;