NppCSharpPluginPack

This is a template for Notepad++ plugins written in C#. The vast majority of the code (certainly all the parts that were really hard to implement) come from kbilsted's now-archived NotepadPlusPlusPluginPack.Net, with some significant changes, including:

1. A simpler architecture in which the PluginInfrastructure folder is side-by-side with the rest of the plugin's code, rather than in a separate directory tree.
2. An example of a non-docking (pop-up) dialog opened from the plugin menu, a docking form, and a non-docking non-pop-up form.
3. A settings form that makes it easy for the maintainer to add, remove or edit settings.
4. A template for automated tests that can be run inside Notepad++, including a template for user interface tests that automatically test forms.

If you have any issues, see if updating to the latest release helps, and then feel free to raise an issue on GitHub. Please be sure to include diagnostic information about your system, Notepad++ version, and plugin version (go to ?->Debug Info... from the Notepad++ main menu).

Read the docs.

Read information about the plugin architecture (some of this may be out of date)

View past changes.

Using the template

1. Download the source code in one of the following ways:
   • clone the repository
   • download the source code for the repo, then create a git repo inside
   • fork this repo
   • download the source code for a release (see the Releases page)
2. Open NppCSharpPluginPack/NppCSharpPluginPack.sln in Visual Studio 2022
3. Configure the security settings of %ProgramFiles%/Notepad++/plugins so that Visual Studio can write to %ProgramFiles%/Notepad++/plugins/CSharpPluginPack. I do this in the following way:
   1. Open %ProgramFiles%/Notepad++ in the File Explorer.
   2. Right-click on the plugins folder.
   3. Choose Properties from the drop-down menu
   4. Select the Security tab.
   5. Click the Edit... checkbox
   6. Select Users from the Group or user names menu, then click the checkbox in the Full Control row of the Allow column.
   7. Click the Apply button.
4. Try building the project using Visual Studio using x64 build target (this build for 64-bit Notepad++). You will know that the project is working correctly when Notepad++ starts up, and CSharpPluginPack appears on the list of plugins.
5. Try changing the assembly version in NppCSharpPluginPack/Properties/AssemblyInfo.cs to 1.0.3.0.
6. Try building the project again, then select Plugins->CSharpPluginPack->About from the Notepad++ dropdown menu. The title of the about form should read NppCSharpPluginPack v1.0.3. If it does not, your project is not building correctly.
7. Copy the testfiles directory of the repo to the %ProgramFiles%/Notepad++/plugins/CSharpPluginPack directory.
8. Run the tests. The third line of the test results file should read No tests failed. If you see Tests failed: Performance of something on the third line, that's because you forgot step 7.
9. To test your project for 32-bit Notepad++, repeat steps 3-8 for %ProgramFiles (x86)%/Notepad++/plugins and change your build target to x86.

System Requirements

This plugin is verified to work on versions of Notepad++ as old as v7.3.3, but it may have some bugs (see the CHANGELOG to see the what bugs may still exist).

It has also been tested and verified to work normally on the newest versions of Notepad++, v8.6.1 and v8.6.2 RC.

Every version of the template works on Windows 10 May 2019 update or later, or you must install .NET Framework 4.8.

Translating your plugin to another language

If you are interested in helping users of your plugin who don't speak English, this plugin pack makes it easy to translate your plugin to other languages beginning in v0.0.3.7.

Translator.cs infers your preferred language and attempts to translate in the following way:

1. It looks up your current culture (which can be checked using the get-culture command in Powershell).
2. Next, we find the EnglishName property of the current culture (which can be found by the $foo = get-culture; $foo.EnglishName command in Powershell), take the first word, and convert it to lowercase. Call this lowerEnglishCulture.
   • Example: the EnglishName of the en-us culture is English (United States), so lowerEnglishCulture is english
   • Example: the EnglishName of the it-it culture is Italian (Italy), so lowerEnglishCulture is italian
3. It then does one of the following:
   • If lowerEnglishName is english, it does nothing (because the plugin is naturally in English)
   • Otherwise, it looks in the translation subdirectory of the CSharpPluginPack plugin folder (where CSharpPluginPack.dll lives) for a file named {lowerEnglishName}.json5
   • NOTE: because the translation files are in a subdirectory of the plugin folder, translation does not work for versions of Notepad++ older than version 8, since those older versions do not have separate folders for each plugin.
4. If Translator found translation\{lowerEnglishName}.json5, it attempts to parse the file. If parsing fails, a message box will appear warning the user of this.
   • If no translation file was found, or if parsing failed, the default English will be used.
5. If parsing was successful, Translator will use the translation file as described below.

To be clear, the plugin may not be in the same language of the Notepad++ UI, although I may change that in the future.

To translate your plugin to another language, just look at english.json5 in the translations directory of this repo and follow the instructions in that file.

Currently NppCSharpPluginPack has been translated into the following languages:

Language	First version with translation	Translator	Translator is native speaker?
Spanish	v3.7	molsonkiko	NO

The following aspects of NppCSharpPluginPack can be translated:

• Forms (including all controls and items in drop-down menus)
• Items in the NppCSharpPluginPack sub-menu of the Notepad++ Plugins menu
• The descriptions of settings in the CSharpPluginPack.ini config file and settings form

The following aspects of NppCSharpPluginPack may eventually be translated:

• This documentation
• Message boxes (includes warnings, errors, requests for confirmation)
• Generic modal dialogs (for example, file-opening dialogs, directory selection dialogs)

Acknowledgments

• Kasper B. Graversen for creating the plugin pack that this is based on.
• jokedst for making the CsvQuery plugin to which I owe the original ideas behind my settings form and my adaptive styling of forms.
• And of course, Don Ho for creating Notepad++!