Skip to content

Commit

Permalink
Merge pull request #472 from DissNik/2.0
Browse files Browse the repository at this point in the history
chore: troubleshooting
  • Loading branch information
DissNik authored May 8, 2024
2 parents d233569 + 91f131b commit 734d298
Show file tree
Hide file tree
Showing 2 changed files with 108 additions and 92 deletions.
100 changes: 54 additions & 46 deletions resources/views/pages/en/troubleshooting.blade.php
Original file line number Diff line number Diff line change
@@ -1,48 +1,56 @@
<x-page title="Frequent problems" :sectionMenu="null">
<x-sub-title>Images are not displayed</x-sub-title>
<x-page title="Frequent problems" :sectionMenu="[
'Sections' => [
['url' => '#images-are-not-displayed', 'label' => 'Images are not displayed'],
['url' => '#default-language', 'label' => 'Default language'],
['url' => '#problems-with-https', 'label' => 'Problems with https'],
['url' => '#error-page-not-found', 'label' => 'Error Page not found'],
]
]">

<x-sub-title id="images-are-not-displayed">Images are not displayed</x-sub-title>

<x-ul>
<li>Make sure you've done <code>php artisan storage:link</code></li>
<li>Make sure the disk is selected by default <code>public</code>, not <code>local</code></li>
<li>
Check that <code>APP_URL</code> in <code>.env</code> is correct
<x-code>
APP_URL=http://moonshine.test:8080
</x-code>
</li>
</x-ul>

<x-sub-title id="default-language">Default language</x-sub-title>

<x-p>
If you have left only one language in the MoonShine config, but another language is used in the panel
</x-p>

<x-ul>
<li>Make sure that the Laravel config <code>config/app.php</code> specifies the same language as MoonShine</li>
</x-ul>

<x-sub-title id="problems-with-https">Problems with https</x-sub-title>

<x-p>
If you have forms using url with http, but expect https
</x-p>

<x-ul>
<li>Make sure you have a quality ssl certificate</li>
<li>In middleware <code>TrustProxies</code> set <code>protected $proxies = ['*']</code></li>
</x-ul>

<x-sub-title id="error-page-not-found">Error Page not found</x-sub-title>

<x-ul>
<li>
Check <code>config/app.php</code> for MoonShineServiceProvider.
For example, the Apiato package changes its structure and MoonShine cannot be added by the provider automatically.
Add it yourself
</li>
<li>Make sure the resource or page is declared in MoonShineServiceProvider</li>
<li>Clear cache</li>
</x-ul>

<ol>
<li>Make sure you've done <code>php artisan storage:link</code></li>
<li>Make sure the disk is selected by default <code>public</code>, not <code>local</code></li>
<li>Check that <code>APP_URL</code> in <code>.env</code> is correct</li>
</ol>

<x-sub-title>Default language</x-sub-title>

<x-p>
If you have left only one language in the MoonShine config, but another language is used in the panel
</x-p>

<ol>
<li>Make sure that the Laravel config <code>config/app.php</code> specifies the same language as MoonShine</li>
</ol>

<x-sub-title>Problems with https</x-sub-title>

<x-p>
If you have forms using url with http, but expect https
</x-p>

<ol>
<li>Make sure you have a quality ssl certificate</li>
<li>In middleware <code>TrustProxies</code> set <code>protected $proxies = ['*']</code></li>
</ol>

<x-sub-title>Error Page not found</x-sub-title>

<ol>
<li>
Check <code>config/app.php</code> for MoonShineServiceProvider.
For example, the Apiato package changes its structure and MoonShine cannot be added by the provider automatically.
Add it yourself
</li>

<li>
Make sure the resource or page is declared in MoonShineServiceProvider
</li>

<li>
Clear cache
</li>
</ol>
</x-page>
100 changes: 54 additions & 46 deletions resources/views/pages/ru/troubleshooting.blade.php
Original file line number Diff line number Diff line change
@@ -1,48 +1,56 @@
<x-page title="Частые проблемы" :sectionMenu="null">
<x-sub-title>Не отображаются изображения</x-sub-title>
<x-page title="Частые проблемы" :sectionMenu="[
'Sections' => [
['url' => '#images-are-not-displayed', 'label' => 'Не отображаются изображения'],
['url' => '#default-language', 'label' => 'Язык по умолчанию'],
['url' => '#problems-with-https', 'label' => 'Проблемы с https'],
['url' => '#error-page-not-found', 'label' => 'Ошибка Page not found'],
]
]">

<x-sub-title id="images-are-not-displayed">Не отображаются изображения</x-sub-title>

<x-ul>
<li>Убедитесь что выполнили <code>php artisan storage:link</code></li>
<li>Убедитесь что по умолчанию выбран диск <code>public</code>, а не <code>local</code></li>
<li>
Проверьте что <code>APP_URL</code> в <code>.env</code> соответствует действительности
<x-code>
APP_URL=http://moonshine.test:8080
</x-code>
</li>
</x-ul>

<x-sub-title id="default-language">Язык по умолчанию</x-sub-title>

<x-p>
Если вы оставили в конфиге MoonShine только один язык, но в панели используется другой
</x-p>

<x-ul>
<li>Убедитесь что в конфиге Laravel <code>config/app.php</code> указан тот же язык, что и в MoonShine</li>
</x-ul>

<x-sub-title id="problems-with-https">Проблемы с https</x-sub-title>

<x-p>
Если в формах у вас используются url с http, а ожидаете https
</x-p>

<x-ul>
<li>Убедитесь что у вас качественный ssl сертификат</li>
<li>В middleware <code>TrustProxies</code> установите <code>protected $proxies = ['*']</code></li>
</x-ul>

<x-sub-title id="error-page-not-found">Ошибка Page not found</x-sub-title>

<x-ul>
<li>
Проверьте <code>config/app.php</code> на наличие в нем MoonShineServiceProvider.
К примеру пакет Apiato меняет его структуру и MoonShine не может добавить провайдер автоматически.
Добавьте самостоятельно
</li>
<li>Убедитесь что ресурс или страница объявлены в MoonShineServiceProvider</li>
<li>Сбросьте кеш</li>
</x-ul>

<ol>
<li>Убедитесь что выполнили <code>php artisan storage:link</code></li>
<li>Убедитесь что по умолчанию выбран диск <code>public</code>, а не <code>local</code></li>
<li>Проверьте что <code>APP_URL</code> в <code>.env</code> соответствует действительности</li>
</ol>

<x-sub-title>Язык по умолчанию</x-sub-title>

<x-p>
Если вы оставили в конфиге MoonShine только один язык, но в панели используется другой
</x-p>

<ol>
<li>Убедитесь что в конфиге Laravel <code>config/app.php</code> указан тот же язык, что и в MoonShine</li>
</ol>

<x-sub-title>Проблемы с https</x-sub-title>

<x-p>
Если в формах у вас используются url с http, а ожидаете https
</x-p>

<ol>
<li>Убедитесь что у вас качественный ssl сертификат</li>
<li>В middleware <code>TrustProxies</code> установите <code>protected $proxies = ['*']</code></li>
</ol>

<x-sub-title>Ошибка Page not found</x-sub-title>

<ol>
<li>
Проверьте <code>config/app.php</code> на наличие в нем MoonShineServiceProvider.
К примеру пакет Apiato меняет его структуру и MoonShine не может добавить провайдер автоматически.
Добавьте самостоятельно
</li>

<li>
Убедитесь что ресурс или страница объявлены в MoonShineServiceProvider
</li>

<li>
Сбросьте кеш
</li>
</ol>
</x-page>

0 comments on commit 734d298

Please sign in to comment.