Различия

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

--- wiki:plugin:data [2026/01/18 14:12] – [How to refresh data?] VladPolskiy
+++ wiki:plugin:data [2026/01/18 14:32] (текущий) – [Bugs, Feature Requests and Patches] VladPolskiy
@@ Строка 447: / Строка 447: @@
   * [[:wiki:plugin:data:list_of_employees|Пример использования DokuWiki: список сотрудников]] – Как использовать плагин Data с плагинами [[:wiki:plugin:Bureaucracy]] и [[:wiki:plugin:Wrap]] Руководство от [[user>lolmaus]].
-===== Question and Answers =====
+===== Вопросы и ответы =====
 ==== Как обновить данные? ====
-The data that is copied to the SQLite database //should// be refreshed automatically whenever the page containing the dataentry box is changed. If you deleted or renamed pages outside the wiki, the database will still contain data about now non-existing pages. These can be cleaned using the ''Data Plugin: Clean up database'' entry in the Admin menu.
+Данные, копируемые в базу данных SQLite, должны автоматически обновляться при каждом изменении страницы, содержащей поле ввода данных. Если вы удаляли или переименовывали страницы вне вики, база данных по-прежнему будет содержать данные о страницах, которые теперь не существуют. Их можно очистить с помощью ''Data Plugin: Clean up'' ''database'' соответствующего пункта в меню «Администрирование».
-However there might be some bugs making this not always 100% reliable. Refer to the [[#open bugs]] section and [[#changes]] to see what might be broken or what was recently fixed.
+Однако могут быть некоторые ошибки, из-за которых это не всегда на 100% надежно. Обратитесь к разделу  [[#открытых ошибок]] и [[#изменений]], чтобы узнать, что может быть неисправно или что было недавно исправлено
-When you delete the whole database, all entry pages have to be re-rendered to repopulate the database. There is no automatic way to do so.
+При удалении всей базы данных все страницы ввода данных необходимо перерисовать для восстановления ее содержимого. Автоматического способа сделать это нет.
-In case page were externally modified, or fresh database, few tricks to refresh the database are:
+В случае, если страница была изменена извне или была обновлена база данных, можно использовать несколько способов для ее обновления:
-  * to download the wiki pages, in batch, using wget, a command-line file downloader;
+  * для пакетной загрузки страниц вики с помощью wget, программы для загрузки файлов из командной строки;
-  * to install the [[plugin:searchindex]] plugin, launch the newly added ''SearchIndex Manager'' panel in Admin menu and click the ''Rebuild Index'' button.
+  * Чтобы установить плагин [[wiki:plugin:searchindex]] откройте новую ''SearchIndex Manager'' панель в меню "Администрирование" и нажмите ''Rebuild Index'' кнопку.
+Разумеется, вы можете открыть файл базы данных непосредственно в командной строке SQLite и управлять им с помощью SQL-запросов.
-You can of course open the database file directly in the SQLite command line client and manipulate it through SQL queries.
+==== В чём разница между плагином Strata и плагином Data? ====
-==== What is the difference between Strata plugin and Data plugin? ====
+Плагин [[wiki:plugin:strata|Strata]] по своим функциональным возможностям является аналогом плагина Data. Однако он обладает более сложным синтаксисом запросов, упрощенной системой псевдонимов и дополнительными функциями, такими как построение графиков или вывод данных на основе предопределенного шаблона. Таким образом, для обработки более сложных данных плагин Strata предоставляет больше возможностей.
-The [[plugin:strata|Strata Plugin]] is in the big lines equivalent to Data plugin. However, it has more sophisticated query syntax, less and simpler 'aliastypes' system and additional features like graph or output based at an predefined template. So for handling of more complicated data the Strata Plugin has more opportunities.
+==== Как отфильтровать пустые поля/значения? ====
-==== How do you filter empty fields/values? ====
+Предположим, некоторые записи содержат пустые поля, и вы хотите отобразить такие записи: как написать фильтр в запросе, чтобы вывести их?
-Suppose some entries contain empty fields and you want to display such entries: how do you write the filter in the query to output these?
+например
-e.g.
 <code>
@@ Строка 483: / Строка 482: @@
 </code>
-and if the query is:
+и если запрос выглядит так:
 <code>
 ---- datatable ----
@@ Строка 491: / Строка 490: @@
 ----
 </code>
-the output does not show the above record
+В выходных данных указанная выше запись не отображается.
-^The solution is to change the filter to a value that will always be populated. ^
+^Решение состоит в том, чтобы изменить фильтр на значение, которое будет всегда отображаться. ^
 |<code>---- datatable ----
 cols    : %pageid%
@@ Строка 501: / Строка 500: @@
 |  --- [[user>SFITCS|SFITCS]] //2016-10-15 04:58//|
-==== Why don't my variables/placeholders work when I create a table in a namespace template? ====
+==== Почему мои переменные/заполнители не работают при создании таблицы в шаблоне пространства имен? ====
-DokuWiki calls [[phpfn>strftime]] on ''_template.txt'' when creating a new page. This replaces some combinations of %[a-z] (for example, %title% will become [TAB]itle%). When using placeholders in ''_template.txt'' you should use double percent signs (<nowiki>%%title%%</nowiki>). Strftime will treat those as literal percent characters.
+DokuWiki вызывает функцию [[phpfn>strftime]] ''_template.txt'' при создании новой страницы. Это заменяет некоторые комбинации %[az] (например, %title% станет [TAB]itle%). При использовании заполнителей ''_template.txt'' следует использовать двойные знаки процента (<nowiki>%%title%%</nowiki>). Функция strftime будет рассматривать их как обычные символы процента.
-==== Other Questions ====
+==== Другие вопросы ====
-If you still have questions, search the forum and if it hasn't been asked before ask your question there. Please leave bug reports on Github's issue tracker.
+Если у вас остались вопросы, поищите на форуме, и если этот вопрос ещё не задавался, задайте его там. Пожалуйста, сообщайте об ошибках в системе отслеживания проблем Github.
 ----
-===== Customisations =====
+===== Настройки =====
-**Important!** These are //hacks// -- there is no guarantee they'll always work, and they will **not** survive updates.
+**Важно!** Это лишь //уловки// — нет гарантии, что они всегда будут работать, и они не сохранятся после обновлений.
-If it breaks you get to keep the pieces. :-)
+Если он разобьется, вы сможете оставить себе обломки :-)
-==== Customise the Date Format ====
+==== Настройте формат даты ====
-**NOTE:** The configuration setting for the PHP strftime function in ''/conf/dokuwiki.php'' also need to be changed (can also be changed via **Admin->Configuration**) <code>$conf['dformat']     = '%d/%m/%Y %H:%M';</code>
+**ПРИМЕЧАНИЕ:** ''/conf/dokuwiki.php'' Также необходимо изменить параметр конфигурации функции PHP strftime (это можно сделать через Администрирование → Конфигурация ).
+<code>$conf['dformat']     = '%d/%m/%Y %H:%M';</code>
-To change the default date format from ''yy-mm-dd'' to ''dd-mm-yy'' (e.g. for Australia)
+Чтобы изменить формат даты по умолчанию с ''yy-mm-dd'' на ''dd-mm-yy'' (например, для Австралии)
-Change this:
+Измените это:
 <code php plugins/data/helper.php>
     /**
-     * Replace placeholders in sql
+     * Заменяет заполнители в SQL
      */
-    function _replacePlaceholdersInSQL(&$data) {
+    function _replacePlaceholdersInSQL ( & $data )  {
-        global $USERINFO;
+        global  $USERINFO ;
-        // allow current user name in filter:
+        // разрешить имя текущего пользователя в фильтре:
-        $data['sql'] = str_replace('%user%', $_SERVER['REMOTE_USER'], $data['sql']);
+        $data [ 'sql' ]  =  str_replace ( '%user%' ,  $_SERVER [ 'REMOTE_USER' ] ,  $data [ 'sql' ] ) ;
-        $data['sql'] = str_replace('%groups%', implode("','", (array) $USERINFO['grps']), $data['sql']$
+        $data [ 'sql' ]  =  str_replace ( '%groups%' ,  implode ( "','" ,  ( array )  $USERINFO [ 'grps' ] ) ,  $data [ 'sql' ] $
-        // allow current date in filter:
+         // разрешить текущую дату в фильтре:
-        $data['sql'] = str_replace('%now%', dformat(null, '%Y-%m-%d'), $data['sql']);
+        $data [ 'sql' ]  =  str_replace ( '%now%' , dformat ( null ,  '%Y-%m-%d' ) ,  $data [ 'sql' ] ) ;
-        // language filter
+        // языковой фильтр
-        $data['sql'] = $this->makeTranslationReplacement($data['sql']);
+        $data [ 'sql' ]  =  $this- > makeTranslationReplacement ( $data [ 'sql' ] ) ;
     }
 </code>
-to this:
+к этому:
 <code php plugins/data/helper.php>
     /**
-     * Replace placeholders in sql
+     * Заменяет заполнители в SQL
      */
-    function _replacePlaceholdersInSQL(&$data) {
+    function _replacePlaceholdersInSQL ( & $data )  {
-        global $USERINFO;
+        global  $USERINFO ;
-        // allow current user name in filter:
+        // разрешить имя текущего пользователя в фильтре:
-        $data['sql'] = str_replace('%user%', $_SERVER['REMOTE_USER'], $data['sql']);
+        $data [ 'sql' ]  =  str_replace ( '%user%' ,  $_SERVER [ 'REMOTE_USER' ] ,  $data [ 'sql' ] ) ;
-        $data['sql'] = str_replace('%groups%', implode("','", (array) $USERINFO['grps']), $data['sql']$
+        $data [ 'sql' ]  =  str_replace ( '%groups%' ,  implode ( "','" ,  ( array )  $USERINFO [ 'grps' ] ) ,  $data [ 'sql' ] $
-        // allow current date in filter:
+         // разрешить текущую дату в фильтре:
-        $data['sql'] = str_replace('%now%', dformat(null, '%d-%m-%Y'), $data['sql']);
+        $data [ 'sql' ]  =  str_replace ( '%now%' , dformat ( null ,  '%d-%m-%Y' ) ,  $data [ 'sql' ] ) ;
-        // language filter
+        // языковой фильтр
-        $data['sql'] = $this->makeTranslationReplacement($data['sql']);
+        $data [ 'sql' ]  =  $this- > makeTranslationReplacement ( $data [ 'sql' ] ) ;
     }
 </code>
-and change this:
+и измените это:
 <code php plugins/data/helper.php>
-switch($type) {
+switch ( $type )  {
-            case 'dt':
+            case  'dt' :
-                if(preg_match('/^(\d\d\d\d)-(\d\d?)-(\d\d?)$/', $value, $m)) {
+                if ( preg_match ( '/^(\d\d\d\d)-(\d\d?)-(\d\d?)$/' ,  $value ,  $m ) )  {
-                    return sprintf('%d-%02d-%02d', $m[1], $m[2], $m[3]);
+                    return  sprintf ( '%d-%02d-%02d' ,  $m [ 1 ] ,  $m [ 2 ] ,  $m [ 3 ] ) ;
                 }
 </code>
-to this:
+к этому:
 <code php plugins/data/helper.php>
-switch($type) {
+switch ( $type )  {
-            case 'dt':
+            case  'dt' :
-                if(preg_match('/^(\d\d?)-(\d\d?)-(\d\d\d\d)$/', $value, $m)) {
+                if ( preg_match ( '/^(\d\d?)-(\d\d?)-(\d\d\d\d)$/' ,  $value ,  $m ) )  {
-                    return sprintf('%02d-%02d-%d', $m[1], $m[2], $m[3]);
+                    return  sprintf ( '%02d-%02d-%d' ,  $m [ 1 ] ,  $m [ 2 ] ,  $m [ 3 ] ) ;
                 }
 </code>
-and change this:
+и измените это:
 <code javascript plugins/data/script.js>
 /**
- * Init datepicker for all date fields
+ * Инициализация средства выбора даты для всех полей даты
  */
-jQuery(function () {
+jQuery ( function  ( )  {
-    jQuery('.data_type_dt input').datepicker({
+    jQuery ( '.data_type_dt input' ) . datepicker ( {
-        dateFormat: "yy-mm-dd",
+        dateFormat :  "yy-mm-dd" ,
-        changeMonth: true,
+        changeMonth :  true ,
-        changeYear: true
+        changeYear :  true
-    });
+    } ) ;
 </code>
-to this:
+к этому:
 <code javascript plugins/data/script.js>
 /**
- * Init datepicker for all date fields
+ * Инициализация средства выбора даты для всех полей даты
  */
-jQuery(function () {
+jQuery ( function  ( )  {
-    jQuery('.data_type_dt input').datepicker({
+    jQuery ( '.data_type_dt input' ) . datepicker ( {
-        dateFormat: "dd-mm-yy",
+        dateFormat :  "dd-mm-yy" ,
-        changeMonth: true,
+        changeMonth :  true ,
-        changeYear: true
+        changeYear :  true
-    });
+    } ) ;
 </code>  --- [[user>SFITCS]] //2016-11-26 01:24//
-===== Bugs, Feature Requests and Patches =====
+===== Сообщения об ошибках, запросы на добавление новых функций и исправления. =====
+Пожалуйста, сообщайте об ошибках и предлагайте новые функции в [[https://github.com/splitbrain/dokuwiki-plugin-data/issues|системе отслеживания ошибок на GitHub]]. Патчи следует отправлять в формате унифицированного сравнения изменений (unified diff format) или в виде git-патчей для ветки devel. Или еще лучше: создайте форк репозитория на GitHub и отправьте запрос на слияние (merge request).
+===== Дополнения и Файлы=====
+  * [[https://www.dokuwiki.org/plugin:data|Ссылка на оригинальную статью]]
+  * {{ :wiki:plugin:splitbrain-dokuwiki-plugin-data-2024-01-30-2-gcecb410.zip |Скачать plugin data}}
-Please submit bugs and feature requests in the [[https://github.com/splitbrain/dokuwiki-plugin-data/issues|issue tracker on GitHub]]. Patches should be sent unified diff format or as git patches against the devel branch. Or even better: fork the repository at github and send a merge request.