You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Apr 24, 2023. It is now read-only.
System plugin for Joomla 3.7+ for importing and exporting articles with additional fields
9
+
System plugin for Joomla! 3.7+ for importing and exporting articles with custom fields.
10
10
11
-
The plugin is designed to import and export standard articles and custom additional fields for them.
11
+
Adapted for Joomla! 4.
12
+
13
+
The plugin is designed to import and export standard articles and custom custom fields for them.
12
14
13
15
Export is initially adapted for opening the resulting file in MS Excel or its analogs.
14
16
@@ -35,9 +37,9 @@ Fields **articleid** and **articletitle** are required, if they are missing, dat
35
37
36
38
Any other main article fields are ignored.
37
39
38
-
Any other field names are taken as the names of additional article fields. In cases where the article does not contain the indicated additional fields, the latter will be ignored.
40
+
Any other field names are taken as the names of custom article fields. In cases where the article does not contain the indicated custom fields, the latter will be ignored.
39
41
40
-
The discrepancy between the number of values in the row and the discrepancy with the number of field headers leads to the refusal to process this row. When importing, additional article fields that are not in the file are not affected.
42
+
The discrepancy between the number of values in the row and the discrepancy with the number of field headers leads to the refusal to process this row. When importing, custom article fields that are not in the file are not affected.
41
43
42
44
Data on import errors is stored in the *cfi.php* log in the standard Joomla log folder.
43
45
@@ -49,13 +51,13 @@ If there are no data import errors, the imported file is deleted, otherwise the
49
51
50
52
When exporting, data is written to the file as is, in the format in which it is stored in the database of your site: plain text, text with HTML markup, json structures and other complex string structures.
51
53
52
-
For standard additional Joomla fields of a list type that return the structure of the stored data in the form of unassociated arrays, json is returned to the resulting file. For non-standard fields, the structure `array::` is written before the json value in the file: this is necessary so that with the possible subsequent import of this data, the plugin can parse the json value from the file and substitute the prepared array for the corresponding field. If you don’t understand anything from the above phrase, it’s okay, just don’t touch the value of `array ::` in your file or delete this column completely in order to avoid damage to the data of the corresponding article field.
54
+
For standard custom Joomla fields of a list type that return the structure of the stored data in the form of unassociated arrays, json is returned to the resulting file. For non-standard fields, the structure `array::` is written before the json value in the file: this is necessary so that with the possible subsequent import of this data, the plugin can parse the json value from the file and substitute the prepared array for the corresponding field. If you don’t understand anything from the above phrase, it’s okay, just don’t touch the value of `array ::` in your file or delete this column completely in order to avoid damage to the data of the corresponding article field.
53
55
54
56
---
55
57
56
58
### Data protection during import
57
59
58
-
The data of additional fields are written to the database by direct queries and are not subjected to any processing. Due to the fact that this data may contain HTML markup tags, json strings or other string constructs containing specialized characters, **data is not shielded!** Please ensure the safety of the imported data at the stage of generating the file for importing data into Joomla .
60
+
The data of custom fields are written to the database by direct queries and are not subjected to any processing. Due to the fact that this data may contain HTML markup tags, json strings or other string constructs containing specialized characters, **data is not shielded!** Please ensure the safety of the imported data at the stage of generating the file for importing data into Joomla .
59
61
60
62
**The plugin developer is not responsible for the incorrect content of the imported files, which may damage your site**.
Системный плагин для Joomla! 3.7+ для импорта и экспорта материалов с участием дополнительных полей.
7
+
Системный плагин для Joomla! 3.7+ для импорта и экспорта материалов с участием настраиваемых полей.
8
8
9
-
Плагин предназначен для импорта и экспорта стандартных материалов и кастомных дополнительных полей для них.
9
+
Адаптировано для Joomla! 4.
10
+
11
+
Плагин предназначен для импорта и экспорта стандартных материалов и кастомных настраиваемых полей для них.
10
12
11
13
Экспорт изначально адаптирован под открытие результирующего файла в MS Excel или его аналогах.
12
14
13
15
#### ВАЖНО:
14
16
15
-
- Плагин не обрабатывает содержимое материалов и кастомных дополнительных полей!
17
+
- Плагин не обрабатывает содержимое материалов и кастомных настраиваемых полей!
16
18
- Плагин не обрабатывает изображения для вступительного и полного текста материала!
17
19
- При выборе конкретной категории вложенные категории не обрабатываются! Это сделано специально: не всем и не всегда необходимо обрабатывать вложенные категории.
18
20
- Плагин не обрабатывает категории материалов и категории вообще: только сами материалы! При импорте данных категории не создаются!
19
21
20
-
**Причина вышеописанных ограничений и оговорок очень проста: изначальная цель работы плагина – *обработка кастомных дополнительных полей материала*, и не более того.**
22
+
**Причина вышеописанных ограничений и оговорок очень проста: изначальная цель работы плагина – *обработка кастомных настраиваемых полей материала*, и не более того.**
21
23
22
24
---
23
25
@@ -42,7 +44,7 @@
42
44
43
45
Любые иные основные поля материала игнорируются.
44
46
45
-
Любые иные имена полей принимаются за имена дополнительных полей материала. В случаях отстутствия у материала указанных дополнительных полей последние будут игнорироваться.
47
+
Любые иные имена полей принимаются за имена настраиваемых полей материала. В случаях отстутствия у материала указанных настраиваемых полей последние будут игнорироваться.
46
48
47
49
Несоответствие количества значений в строке несоответствию количеству заголовков полей приводит к отказу от обработки этой строки. При импорте дополнятельные поля материала, отсутствующие в файле, не затрагиваются.
48
50
@@ -56,13 +58,13 @@
56
58
57
59
При экспорте данные записываются в файл как есть, в том формате, в котором они хранятся в БД вашего сайта: простой текст, текст с разметкой HTML, структуры json, иные сложные строковые структуры.
58
60
59
-
Для стандартных дополнительных полей Joomla списочного типа, возвращающих структуры хранимых данных в виде неассоциированных массивов, в результирующий файл возвращается json. Для нестандартных полей в файл перед json-значением записывается структура `array::`: это необходимо для того, чтобы при возможном последующем импорте этих данных плагин смог разобрать json-значение из файла и подставить соответствующему полю подготовленный массив. Если из вышеуказанной фразы вы ничего не поняли – не страшно, просто не трогайте значение `array::` в вашем файле или удалите этот столбец полностью во избежание повреждения данных соответсвующего поля материала.
61
+
Для стандартных настраиваемых полей Joomla списочного типа, возвращающих структуры хранимых данных в виде неассоциированных массивов, в результирующий файл возвращается json. Для нестандартных полей в файл перед json-значением записывается структура `array::`: это необходимо для того, чтобы при возможном последующем импорте этих данных плагин смог разобрать json-значение из файла и подставить соответствующему полю подготовленный массив. Если из вышеуказанной фразы вы ничего не поняли – не страшно, просто не трогайте значение `array::` в вашем файле или удалите этот столбец полностью во избежание повреждения данных соответсвующего поля материала.
60
62
61
63
---
62
64
63
65
### Защита данных при импорте
64
66
65
-
Данные дополнительных полей записываются в БД прямыми запросами и не подвергаются какой-либо обработке. Ввиду того, что в этих данных могут присутствовать теги HTML-разметки, json-строки или иные строковые конструкции, содержащие специализированные символы, **экранирование данных не производится!** Пожалуйста, обеспечьте безопасность импортируемых данных на этапе генерации файла для импорта данных в Joomla.
67
+
Данные настраиваемых полей записываются в БД прямыми запросами и не подвергаются какой-либо обработке. Ввиду того, что в этих данных могут присутствовать теги HTML-разметки, json-строки или иные строковые конструкции, содержащие специализированные символы, **экранирование данных не производится!** Пожалуйста, обеспечьте безопасность импортируемых данных на этапе генерации файла для импорта данных в Joomla.
66
68
67
69
**Разработчик плагина не несёт ответственность за некорректное содержимое импортируемых файлов, которое может вывести из строя ваш сайт**.
Copy file name to clipboardExpand all lines: language/en-GB/en-GB.plg_system_cfi.ini
+5-5Lines changed: 5 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@
4
4
; @license GNU General Public License version 3 or later; see http://www.gnu.org/licenses/gpl-3.0.txt
5
5
6
6
PLG_CFI="System - CFI"
7
-
PLG_CFI_XML_DESCRIPTION="Plugin for importing and exporting articles with additional fields"
7
+
PLG_CFI_XML_DESCRIPTION="Plugin for importing and exporting articles with custom fields"
8
8
PLG_CFI_PARAM_CP="Code page for file conversion"
9
9
PLG_CFI_PARAM_SHOWDESC="Show a description of the format of the imported file"
10
10
PLG_CFI_BUTTON="Import and export CSV"
@@ -13,7 +13,7 @@ PLG_CFI_CB_UTF_CONVERT="Convert encoding UTF-8 <=> %s (encoding is selected in t
13
13
14
14
PLG_CFI_SELECT_CATEGORIES="– Select category –"
15
15
PLG_CFI_BTN_EXPORT="Export articles"
16
-
PLG_CFI_NO_SELECT_CATEGORY="No category has been selected for export. Additional article fields are assigned to categories, so selecting a category is required."
16
+
PLG_CFI_NO_SELECT_CATEGORY="No category has been selected for export. custom article fields are assigned to categories, so selecting a category is required."
17
17
PLG_CFI_EXPORT_SUCCESS="Export complete"
18
18
PLG_CFI_EXPORT_ERROR="Error exporting data"
19
19
PLG_CFI_EXPORT_NO_CATEGORY="Category not specified or incorrectly specified"
@@ -48,7 +48,7 @@ PLG_CFI_RESULT="<span>Imported records from file: <strong>%s</strong><br>New art
PLG_CFI_DESC_FORMAT_LABEL="Description of the file format"
51
-
PLG_CFI_DESC_FORMAT="<p><strong>Description of the file format of the imported articles with additional fields</strong></p>
51
+
PLG_CFI_DESC_FORMAT="<p><strong>Description of the file format of the imported articles with custom fields</strong></p>
52
52
<p>File format for imported data: <strong>CSV</strong>. Default a file encoding, if the option «Convert encoding…» is not set: <strong>UTF-8 w/o BOM</strong>. The data separator in the CSV file must be only the <code>;</code> symbol.</p>
53
53
<p>The first line of a file is always the file field headers.</p>
54
54
<p>Reserved field names:</p>
@@ -59,13 +59,13 @@ PLG_CFI_DESC_FORMAT="<p><strong>Description of the file format of the imported a
59
59
<p><code>articleintrotext</code> – introductory text of the article;</p>
60
60
<p><code>articlefulltext</code> – the full text of the article.</p>
61
61
<p>The fields <i>articleid</i> and <i>articletitle</i> are required; if they are absent, data will not be imported from the file.</p>
62
-
<p>Any other field names are taken as the names of additional article fields. In cases of absence of the indicated fields from the article, the latter will be ignored.</p>
62
+
<p>Any other field names are taken as the names of custom article fields. In cases of absence of the indicated fields from the article, the latter will be ignored.</p>
63
63
<p>Inconsistency of the number of values in the row to the discrepancy in the number of field headers leads to the refusal to process this row.</p>
64
64
<p>Data on import errors is stored in the <i>cfi.php</i> log in the standard Joomla log folder.</p>
65
65
<p>If there are no data import errors, the imported file is deleted, otherwise the file is saved in the standard Joomla temporary files folder.</p>"
66
66
67
67
PLG_CFI_DESC_WARN_LABEL="Disclaimer"
68
-
PLG_CFI_DESC_WARN="<p>The data of additional fields are written to the database by direct queries and are not subjected to any processing.
68
+
PLG_CFI_DESC_WARN="<p>The data of custom fields are written to the database by direct queries and are not subjected to any processing.
69
69
Due to the fact that html markup tags, json strings or other string constructs containing specialized characters may be present in this data,
70
70
<strong>Data is not shielded!</strong> Please ensure the safety of the imported data during the generation of the file for importing data into Joomla.</p>
0 commit comments