Plugin:DbEditorPP: Difference between revisions

From Miranda NG
Plugin:DbEditorPP
Jump to navigation Jump to search
(changed plugin name according to r3732)
No edit summary
 
(6 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{PluginCard
<languages/>{{PluginCard}}
| name=Database editor++
{{TNT|Important|<translate><!--T:1--> If unsure, backup your profile before using this plugin to alter settings in the database.</translate>}}
| screenshot=dbeditor.png
<translate>
| authors={{while|tpl=Developer|Bio|Jonathan Gordon}}
<!--T:2-->
| dll=DbEditorPP.dll
Advanced database editor.
}}{{Languages}}
Редактор базы. Этот плагин потребуется вам для изменения некоторых настроек Миранды, так как не все они выводятся в диалогах настроек. Необходимо понимать, что использование таких настроек обычно не поддерживается официально и может привести к дополнительным эффектам. Если вы не уверены, обязательно сделайте резервную копию профиля перед использованием плагина!


== Предназначение ==
== Purpose == <!--T:3-->
Миранда хранит настройки ядра и всех плагинов в собственной базе данных (файл с расширением <tt>.dat</tt> в папке, где установлена Миранда, либо в профиле пользователя системы). База выполняет для Миранды те же функции, что и реестр для Windows и большинства приложений. Преимущества отдельной базы: переносимость (портабильность) программы и простота создания резервных копий профиля. При этом нет необходимости копировать настройки из реестра или что-либо переустанавливать — в файле профиля хранится всё: и настройки, и контакты, а также история сообщений.


Настройки в базе бывают двух типов: глобальные и для отдельно взятого контакта. С помощью данного редактора можно изменять и те, и другие:
<!--T:4-->
* '''Глобальные''' — находятся в разделе «Настройки» в левой панели редактора.
Miranda stores all core and plugin settings in its database. The database is, in some ways, comparable to the Windows registry, though it is much simpler but it basically serves the same purpose to Miranda than the registry does to Windows and most Windows applications. The advantage of the database solution is that it is portable and easy to backup – no need to collect settings from the registry or reinstall everything – your profile database holds everything, settings, contacts and messages.
* '''Для контактов''' — каждый контакт имеет свой подраздел в разделе «Контакты» в левой панели редактора; щелкните имя контакта, чтобы развернуть его настройки.


Database Editor '''не предназначен''' для просмотра/правки сообщений.
<!--T:5-->
The DbEditor plugin can be used to view all the settings currently in the database, both global and "per contact" settings. There are 2 types of settings you can view or change:
* '''Global settings''' – in the left pane of the editor, they can all be found under the '''Settings''' node.
* '''Per contact settings''' – each contact has its own node in the left pane and you must expand it to see all settings that are stored for a particular contact.


== Использование ==
<!--T:6-->
Пользуются редактором базы так же, как и редактором реестра Windows. В левой панели редактора находится дерево настроек. Раздел «Настройки» состоит из подразделов, называемых также «ветками модулей». Щелчок по ветке выводит в правой панели все настройки данного модуля. В каждой ветке собраны настройки какого-либо плагина, протокола или группы функций. В отличие от реестра Windows ветки модулей в базе Миранды не имеют подразделов. Иерархия одноуровневая: «Модуль → Настройка».
The database editor {{Strong|cannot}} be used to view or modify messages.


Для изменения скрытых настроек плагина {{Plugin|TabSRMM}} редактируйте только '''глобальные''' настройки. Не задавайте параметрам недокументированные значения — это всё равно что наугад изменять значения в реестре Windows. Неправильное изменение параметров базы может привести к серьезным неполадкам в работе Миранды. Поэтому редактируйте только те настройки, назначение которых '''вам известно'''.
<!--T:7-->
You need this plugin to change some advanced settings for Miranda NG, because some tweaks do not have entries in Miranda's settings dialogs. You need to realize that using these advanced tweaks is basically unsupported and might have unknown side effects.


Не изменяйте настроек контактов, если вы не уверены в своих действиях.
== Usage == <!--T:8-->
</translate>
[[File:DbEditor - start.png|200px|thumb|<translate><!--T:9--> Starting DbEditor from Profile manager</translate>]]
<translate>
<!--T:10-->
There are several ways to open database editor window:
* From the main menu: {{Menu|Main menu|Database|Database Editor++}}
* By hotkey (default is <tvar|hotkey>{{Hotkey|Shift|Win|D}}</>)
* From contact menu: ''Open user tree in DBE++'' (opens settings tree of the given contact)
* On Miranda NG start:
** from Profile manager – select <tvar|dll_name><tt>DbEditorPP.dll</tt></> in the drop-down list "Start in Service Mode with" (see the screenshot)
** using <tvar|launch_command><tt>/svc:dbeditorpp</tt></> command line parameter


== Дополнительные возможности ==
<!--T:11-->
* Наблюдение в режиме реального времени за изменением значений указанных настроек (например, для отладки, когда требуется узнать, значение какого ключа изменяется и когда это происходит).
Using it is straightforward, very much like you are using registry editor. In the left pane, you see the '''modules''' and when you click a module, the right pane will show all the settings for that module. Modules are usually organized either per plugin, per protocol or per function group and unlike the registry there are no sub-keys. The hierarchy is simpler, only one level of '''Module → Setting'''.
* Экспорт и импорт настроек (всех или для отдельного модуля).
 
<!--T:12-->
Always remember to use the {{Strong|global}} settings when using the database tweaks for {{Plugin|TabSRMM}} and do not change any non-documented values. This is as dangerous as randomly changing values in the Windows registry – a wrong change can seriously harm the functionality of Miranda. So only change values {{Strong|you know}} or were advised to change.
 
<!--T:13-->
Also, do not change per contact settings, unless you know exactly what you are doing.
 
== Additional functionality == <!--T:14-->
 
<!--T:15-->
Database editor has some additional functions which can assist with:
* Watching a value in real time (useful for debugging when you need to see when database values are changed).
* Exporting and importing large chunks of settings between different profiles.
* Deleting needless resident settings (those that should exist only in memory without being written to the database).
</translate>
 
{{PluginGroups}}

Latest revision as of 13:51, 12 April 2021

Database editor++
Database editor++
Filename DbEditorPP.dll
Authors Bio, Jonathan Gordon
Download links
Stable version: 32-bit, 64-bit
Development version: 32-bit, 64-bit

Important
If unsure, backup your profile before using this plugin to alter settings in the database.

Advanced database editor.

Purpose

Miranda stores all core and plugin settings in its database. The database is, in some ways, comparable to the Windows registry, though it is much simpler but it basically serves the same purpose to Miranda than the registry does to Windows and most Windows applications. The advantage of the database solution is that it is portable and easy to backup – no need to collect settings from the registry or reinstall everything – your profile database holds everything, settings, contacts and messages.

The DbEditor plugin can be used to view all the settings currently in the database, both global and "per contact" settings. There are 2 types of settings you can view or change:

  • Global settings – in the left pane of the editor, they can all be found under the Settings node.
  • Per contact settings – each contact has its own node in the left pane and you must expand it to see all settings that are stored for a particular contact.

The database editor cannot be used to view or modify messages.

You need this plugin to change some advanced settings for Miranda NG, because some tweaks do not have entries in Miranda's settings dialogs. You need to realize that using these advanced tweaks is basically unsupported and might have unknown side effects.

Usage

Starting DbEditor from Profile manager

There are several ways to open database editor window:

  • From the main menu: Main menu → Database → Database Editor++
  • By hotkey (default is ⇧ Shift+⊞ Win+D)
  • From contact menu: Open user tree in DBE++ (opens settings tree of the given contact)
  • On Miranda NG start:
    • from Profile manager – select DbEditorPP.dll in the drop-down list "Start in Service Mode with" (see the screenshot)
    • using /svc:dbeditorpp command line parameter

Using it is straightforward, very much like you are using registry editor. In the left pane, you see the modules and when you click a module, the right pane will show all the settings for that module. Modules are usually organized either per plugin, per protocol or per function group and unlike the registry there are no sub-keys. The hierarchy is simpler, only one level of Module → Setting.

Always remember to use the global settings when using the database tweaks for TabSRMM and do not change any non-documented values. This is as dangerous as randomly changing values in the Windows registry – a wrong change can seriously harm the functionality of Miranda. So only change values you know or were advised to change.

Also, do not change per contact settings, unless you know exactly what you are doing.

Additional functionality

Database editor has some additional functions which can assist with:

  • Watching a value in real time (useful for debugging when you need to see when database values are changed).
  • Exporting and importing large chunks of settings between different profiles.
  • Deleting needless resident settings (those that should exist only in memory without being written to the database).