/NppCSharpPluginPack

A template for making Notepad++ plugins in C#

Primary LanguageC#Apache License 2.0Apache-2.0

NppCSharpPluginPack

Continuous Integration

License

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.

Acknowledgments