Различия

Показаны различия между двумя версиями страницы.

--- software:development:demo:cms:ucms:creating_sample_install_php [2026/05/04 15:52] – [Файл tpl_install_header.php] VladPolskiy
+++ software:development:demo:cms:ucms:creating_sample_install_php [2026/05/05 11:15] (текущий) – [Дополнения и Файлы] VladPolskiy
@@ Строка 10: / Строка 10: @@
   * Все стили оформления будут перенесены в отдельный внешний файл **install.css.**
 Для удобства редактирования каждая значимая строка кода снабжена подробными комментариями.
+<note shadow>
+<html>
+<iframe height="350" width="550" scrolling="yes" title="Untitled" src="./demo_ucms/install_php_module_template/install.php" frameborder="no" loading="lazy" allowtransparency="true" allowfullscreen="true">
+</iframe>
+</html>
+</note>
 ===== Директории =====
+Директории это структурные элементы файловой системы, предназначенные для логической группировки связанных файлов проекта (шаблонов, стилей и скриптов). Правильное распределение ресурсов по папкам обеспечивает чистоту кода и упрощает поддержку модуля.\\
+Ниже приведена схема файлов и директорий шаблона модуля install.php:
 <diagram>
 |AAA||||||AAA{text-align:left;border-color:white}={{fa>folder?}} ./ucms/
@@ Строка 1122: / Строка 1130: @@
   </style>
 </code>
-Чтобы сделать этот вызов безопасным и более правильным с точки зрения разработки, стоит добавить проверку наличия файла и использовать функцию для чтения содержимого.
+**1.** Чтобы сделать этот вызов безопасным и более правильным с точки зрения разработки, стоит добавить проверку наличия файла и использовать функцию для чтения содержимого.
 <code php tpl_install_footer.php>
@@ Строка 1134: / Строка 1142: @@
 </style>
 </code>
-Для чистого кода  большинство стандартных тегов (вроде **%%DOCTYPE%%** или **%%charset%%**) комментировать не принято, так как их назначение очевидно любому разработчику. Стоит оставить только те комментарии, которые объясняют логику приложения.\\
+**2.** Для чистого кода  большинство стандартных тегов (вроде **%%DOCTYPE%%** или **%%charset%%**) комментировать не принято, так как их назначение очевидно любому разработчику. Стоит оставить только те комментарии, которые объясняют логику приложения.\\
 **Оптимальный вариант**:
 <code php tpl_install_header.php>
@@ Строка 1161: / Строка 1169: @@
 </code>
 ==== Файл tpl_install_footer.php ====
-==== Файл install.php ====
+**1.**Для чистого кода в этом блоке достаточно одного краткого комментария. Все закрывающие теги и так понятны из структуры HTML.\\
+**Оптимальный вариант**:
+<code php tpl_install_footer.php>
+			<!-- Конец блока вставки файлов программы -->
+		</div>
+		<!-- Подвал страницы с копирайтом и версией -->
+		<div class="footer">
+		  <p>
+			Author: <a href="mailto:PolskiyVN@gmail.com">VladPolskiy</a> &copy; 2024-2025
+			<a href="https://UniversalCMS-ce.ovh/" target="_blank">UniversalCMS CE</a> – Ver: 1.2.10
+		  </p>
+		</div>
+	</div>
+</body>
+</html>
+</code>
 ==== Файл install.css ====
+В CSS-коде обычно оставляют комментарии только для сложных логических решений или для визуального разделения крупных секций. Описание стандартных свойств (вроде **%%color%%** или **%%margin%%**) считается избыточным.
+Пример оформленного CSS кода:
+<code css install.css>
+    /* Базовые настройки страницы */
+    body {
+      font-family: "Times New Roman", Times, serif, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+      background-color: #f4f7f6;
+      display: flex;
+      justify-content: center;
+      min-height: 100vh;
+      margin: 0;
+      color: #333;
+    }
+    .install-container {
+      width: 100%;
+      max-width: 700px;
+      padding: 20px;
+      margin: 20px auto 0;
+    }
+    /* Карточка установщика */
+    .install-card {
+      border: 2px #808080 solid;
+      background: #e3ffec;
+      border-radius: 5px;
+      padding: 15px;
+      box-shadow: 0 15px 25px -4px rgba(0, 0, 0, 0.5);
+    }
+    .install-title {
+      font-size: 18px;
+      font-style: italic;
+      font-weight: 700;
+      color: #808080;
+      margin-left: 25px;
+      padding-bottom: 5px;
+    }
+    /* Стили таблицы параметров */
+    table {
+      font-family: inherit;
+      font-weight: 700;
+      font-size: 14px;
+      width: 100%;
+      border-collapse: collapse;
+      margin: 20px 0;
+    }
+    td {
+      padding: 5px 0;
+      border-bottom: 1px dashed #bddbc5;
+    }
+    td:last-child {
+      text-align: left;
+      padding-left: 25%; /* Смещение значений вправо */
+    }
+    .status-ok {
+      color: #2e7d32;
+      font-weight: bold;
+    }
+    /* Служебные блоки: подсказки и ошибки */
+    .hint {
+      font-size: 0.9em;
+      color: #666;
+      line-height: 1.5;
+    }
+    .error-msg {
+      background: #ffdce0;
+      padding: 2px 20px;
+      border-radius: 5px;
+      border-left: 5px solid #d32f2f;
+      margin-top: 5px;
+    }
+    .error-msg p {
+      margin: 0;
+    }
+    .footer {
+      text-align: center;
+      font-size: 13px;
+      font-style: italic;
+      font-weight: 700;
+      color: #888;
+      margin-top: 20px;
+    }
+    .footer a { color: #666; }
+    /* Стили для табличных форм ввода */
+    .form-table {
+        border-collapse: collapse;
+        margin-top: 1em;
+        width: 100%;
+    }
+    .form-table th,
+    .form-table td {
+        padding: 10px 20px 10px 0;
+        font-size: 14px;
+        vertical-align: top;
+        text-align: left;
+    }
+    .form-table th {
+        width: 150px;
+        font-weight: 600;
+    }
+    /* Пояснительный текст под полями ввода */
+    .form-table p {
+        margin: 4px 0 0;
+        font-size: 12px;
+        color: #666;
+    }
+    .form-table input,
+    .form-table select {
+        width: 100%;
+        font-size: 12px;
+        padding: 5px;
+        box-sizing: border-box; /* Гарантирует, что поля не выходят за границы ячеек */
+    }
+</code>
+==== Файл install.php ====
+Оптимизация кода **%%install.php%%** заключается в добавлении семантики, улучшении структуры текста для удобства чтения и добавлении поясняющих комментариев для поддержки кода.
+<code php index.php>
+<?php
+/**
+ * Шаблон мастера установки (Index)
+ * Подключает заголовок, выводит контент.
+ */
+require_once 'tpl/tpl_install_header.php';
+?>
+<main class="install-content">
+	<p>
+		На этом этапе система проверяет совместимость вашего сервера с минимальными требованиями.
+		Будут проверены версия PHP, наличие необходимых расширений (PDO, GD, cURL) и права доступа
+		к ключевым директориям проекта.
+	</p>
+	<p>
+		Если все параметры соответствуют норме, вы сможете перейти к настройке базы данных
+		и созданию учетной записи администратора в следующем шаге.
+	</p>
+</main>
+<?php
+/* Закрывающий шаблон: выводит подвал страницы и закрывает HTML-теги. */
+require_once 'tpl/tpl_install_footer.php';
+?>
+</code>
+Перейдите в браузере по ссылке http://localhost/ucms/library/install/install.php, чтобы проверить окончательный результат на наличие ошибок.
+<note shadow>
+{{:software:development:demo:cms:ucms:ucms_install_test_php_18.png|}}
+</note>
+В этом же окне проверим **%%Ctrl+Shift+I%%** в инструментах разработчика (Developer Tools) поведение страницы при эмуляция мобильных устройств.
+<note shadow>
+{{:software:development:demo:cms:ucms:ucms_install_test_php_19.png|}}
+</note>
+===== Дополнения и Файлы =====
+  * {{ :software:development:demo:cms:ucms:sample_install.rar |Файлы главы Шаблон модуля install.php}}
+  * [[ software:development:demo:cms:ucms:creating_sample_install_php_setting |Файл редактора стилей модуля install.php]]
+  * [[ software:development:demo:cms:ucms:creating_sample_install_php__edit_colors |Файл редактора цветовой схемы модуля install.php]]