We could not synchronize checks via GitHub's checks API since Scrutinizer's GitHub App is not installed for this repository.
| Total Complexity | 43 |
| Total Lines | 250 |
| Duplicated Lines | 0 % |
| Changes | 2 | ||
| Bugs | 1 | Features | 1 |
Complex classes like ThemeServiceProvider often do a lot of different things. To break such a class down, we need to identify a cohesive component within that class. A common approach to find such a component is to look for fields/methods that share the same prefixes, or suffixes.
Once you have determined the fields that belong together, you can apply the Extract Class refactoring. If the component makes sense as a sub-class, Extract Subclass is also a candidate, and is often faster.
While breaking up the class, it is a good idea to analyze how other classes use ThemeServiceProvider, and based on these observations, apply Extract Interface, too.
| 1 | <?php |
||
| 8 | class ThemeServiceProvider extends ServiceProvider |
||
| 9 | { |
||
| 10 | protected string $path; // the root directory of the theme |
||
| 11 | protected string $vendorName = 'backpack'; |
||
| 12 | protected string $packageName = 'theme-name'; |
||
| 13 | protected array $commands = []; |
||
| 14 | protected bool $theme = true; |
||
| 15 | |||
| 16 | /** |
||
| 17 | * ------------------------- |
||
| 18 | * SERVICE PROVIDER DEFAULTS |
||
| 19 | * -------------------------. |
||
| 20 | */ |
||
| 21 | |||
| 22 | /** |
||
| 23 | * Boot method may be overrided by AddonServiceProvider. |
||
| 24 | * |
||
| 25 | * @return void |
||
| 26 | */ |
||
| 27 | public function boot(): void |
||
| 28 | { |
||
| 29 | $this->autoboot(); |
||
| 30 | } |
||
| 31 | |||
| 32 | /** |
||
| 33 | * Perform post-registration booting of services. |
||
| 34 | * |
||
| 35 | * @return void |
||
| 36 | */ |
||
| 37 | public function autoboot(): void |
||
| 38 | { |
||
| 39 | if ($this->packageDirectoryExistsAndIsNotEmpty('bootstrap') && |
||
| 40 | file_exists($helpers = $this->packageHelpersFile())) { |
||
| 41 | require $helpers; |
||
| 42 | } |
||
| 43 | |||
| 44 | if ($this->packageDirectoryExistsAndIsNotEmpty('resources/lang')) { |
||
| 45 | $this->loadTranslationsFrom($this->packageLangsPath(), $this->vendorNameDotPackageName()); |
||
| 46 | } |
||
| 47 | |||
| 48 | if ($this->packageDirectoryExistsAndIsNotEmpty('resources/views')) { |
||
| 49 | $this->loadViews(); |
||
| 50 | } |
||
| 51 | |||
| 52 | if ($this->packageDirectoryExistsAndIsNotEmpty('database/migrations')) { |
||
| 53 | $this->loadMigrationsFrom($this->packageMigrationsPath()); |
||
| 54 | } |
||
| 55 | |||
| 56 | if ($this->packageDirectoryExistsAndIsNotEmpty('routes')) { |
||
| 57 | $this->loadRoutesFrom($this->packageRoutesFile()); |
||
| 58 | } |
||
| 59 | |||
| 60 | // Publishing is only necessary when using the CLI. |
||
| 61 | if (app()->runningInConsole()) { |
||
|
|
|||
| 62 | $this->bootForConsole(); |
||
| 63 | } |
||
| 64 | } |
||
| 65 | |||
| 66 | public function loadViews() |
||
| 67 | { |
||
| 68 | // if this addon is a theme, but isn't active, don't load any views |
||
| 69 | // if ($this->theme && !$this->packageIsActiveTheme()) { |
||
| 70 | // return; |
||
| 71 | // } |
||
| 72 | |||
| 73 | // Load published views |
||
| 74 | if (is_dir($this->publishedViewsPath())) { |
||
| 75 | $this->loadViewsFrom($this->publishedViewsPath(), $this->vendorNameDotPackageName()); |
||
| 76 | } |
||
| 77 | |||
| 78 | // Fallback to package views |
||
| 79 | $this->loadViewsFrom($this->packageViewsPath(), $this->vendorNameDotPackageName()); |
||
| 80 | |||
| 81 | // Add default ViewNamespaces |
||
| 82 | foreach (['buttons', 'columns', 'fields', 'filters', 'widgets'] as $viewNamespace) { |
||
| 83 | if ($this->packageDirectoryExistsAndIsNotEmpty("resources/views/$viewNamespace")) { |
||
| 84 | ViewNamespaces::addFor($viewNamespace, $this->vendorNameDotPackageName()."::{$viewNamespace}"); |
||
| 85 | } |
||
| 86 | } |
||
| 87 | |||
| 88 | // Add basset view path |
||
| 89 | Basset::addViewPath($this->packageViewsPath()); |
||
| 90 | } |
||
| 91 | |||
| 92 | /** |
||
| 93 | * Register any package services. |
||
| 94 | * |
||
| 95 | * @return void |
||
| 96 | */ |
||
| 97 | public function register(): void |
||
| 98 | { |
||
| 99 | if ($this->packageDirectoryExistsAndIsNotEmpty('config')) { |
||
| 100 | $this->mergeConfigFrom($this->packageConfigFile(), $this->vendorNameDotPackageName()); |
||
| 101 | } |
||
| 102 | } |
||
| 103 | |||
| 104 | /** |
||
| 105 | * Console-specific booting. |
||
| 106 | * |
||
| 107 | * @return void |
||
| 108 | */ |
||
| 109 | protected function bootForConsole(): void |
||
| 110 | { |
||
| 111 | // Publishing the configuration file. |
||
| 112 | if ($this->packageDirectoryExistsAndIsNotEmpty('config')) { |
||
| 113 | $this->publishes([ |
||
| 114 | $this->packageConfigFile() => $this->publishedConfigFile(), |
||
| 115 | ], $this->packageName.'-config'); |
||
| 116 | } |
||
| 117 | |||
| 118 | // Publishing the views. |
||
| 119 | if ($this->packageDirectoryExistsAndIsNotEmpty('resources/views')) { |
||
| 120 | $this->publishes([ |
||
| 121 | $this->packageViewsPath() => $this->publishedViewsPath(), |
||
| 122 | ], 'views'); |
||
| 123 | |||
| 124 | // Add basset view path |
||
| 125 | Basset::addViewPath($this->packageViewsPath()); |
||
| 126 | } |
||
| 127 | |||
| 128 | // Publishing assets. |
||
| 129 | if ($this->packageDirectoryExistsAndIsNotEmpty('resources/assets')) { |
||
| 130 | $this->publishes([ |
||
| 131 | $this->packageAssetsPath() => $this->publishedAssetsPath(), |
||
| 132 | ], 'assets'); |
||
| 133 | } |
||
| 134 | |||
| 135 | // Publishing the translation files. |
||
| 136 | if ($this->packageDirectoryExistsAndIsNotEmpty('resources/lang')) { |
||
| 137 | $this->publishes([ |
||
| 138 | $this->packageLangsPath() => $this->publishedLangsPath(), |
||
| 139 | ], 'lang'); |
||
| 140 | } |
||
| 141 | |||
| 142 | // Registering package commands. |
||
| 143 | if (! empty($this->commands)) { |
||
| 144 | $this->commands($this->commands); |
||
| 145 | } |
||
| 146 | } |
||
| 147 | |||
| 148 | /** |
||
| 149 | * ------------------- |
||
| 150 | * CONVENIENCE METHODS |
||
| 151 | * -------------------. |
||
| 152 | */ |
||
| 153 | protected function vendorNameDotPackageName() |
||
| 154 | { |
||
| 155 | return $this->vendorName.'.'.$this->packageName; |
||
| 156 | } |
||
| 157 | |||
| 158 | protected function vendorNameSlashPackageName() |
||
| 159 | { |
||
| 160 | return $this->vendorName.'/'.$this->packageName; |
||
| 161 | } |
||
| 162 | |||
| 163 | // ------------- |
||
| 164 | // Package paths |
||
| 165 | // ------------- |
||
| 166 | |||
| 167 | protected function getPath() |
||
| 168 | { |
||
| 169 | return $this->path ?? base_path('vendor/'.$this->vendorName.'/'.$this->packageName); |
||
| 170 | } |
||
| 171 | |||
| 172 | protected function packageViewsPath() |
||
| 173 | { |
||
| 174 | return $this->getPath().'/resources/views'; |
||
| 175 | } |
||
| 176 | |||
| 177 | protected function packageLangsPath() |
||
| 180 | } |
||
| 181 | |||
| 182 | protected function packageAssetsPath() |
||
| 183 | { |
||
| 184 | return $this->getPath().'/resources/assets'; |
||
| 185 | } |
||
| 186 | |||
| 187 | protected function packageMigrationsPath() |
||
| 190 | } |
||
| 191 | |||
| 192 | protected function packageConfigFile() |
||
| 193 | { |
||
| 194 | return $this->getPath().'/config/'.$this->packageName.'.php'; |
||
| 195 | } |
||
| 196 | |||
| 197 | protected function packageRoutesFile() |
||
| 198 | { |
||
| 199 | return $this->getPath().'/routes/'.$this->packageName.'.php'; |
||
| 200 | } |
||
| 201 | |||
| 202 | protected function packageHelpersFile() |
||
| 205 | } |
||
| 206 | |||
| 207 | // --------------- |
||
| 208 | // Published paths |
||
| 209 | // --------------- |
||
| 210 | |||
| 211 | protected function publishedViewsPath() |
||
| 212 | { |
||
| 213 | return base_path('resources/views/vendor/'.$this->vendorName.'/'.$this->packageName); |
||
| 214 | } |
||
| 215 | |||
| 216 | protected function publishedConfigFile() |
||
| 217 | { |
||
| 218 | return config_path($this->vendorNameSlashPackageName().'.php'); |
||
| 219 | } |
||
| 220 | |||
| 221 | protected function publishedAssetsPath() |
||
| 224 | } |
||
| 225 | |||
| 226 | protected function publishedLangsPath() |
||
| 227 | { |
||
| 228 | return resource_path('lang/vendor/'.$this->vendorName); |
||
| 229 | } |
||
| 230 | |||
| 231 | // ------------- |
||
| 232 | // Miscellaneous |
||
| 233 | // ------------- |
||
| 234 | |||
| 235 | protected function packageDirectoryExistsAndIsNotEmpty($name) |
||
| 250 | } |
||
| 251 | |||
| 252 | public function packageIsActiveTheme() |
||
| 253 | { |
||
| 254 | $viewNamespace = $this->vendorNameDotPackageName().'::'; |
||
| 255 | |||
| 256 | return config('backpack.ui.view_namespace') === $viewNamespace || |
||
| 258 | } |
||
| 259 | } |
||
| 260 |