AreaProg.uTinyMceIcons 1.0.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package AreaProg.uTinyMceIcons --version 1.0.0
NuGet\Install-Package AreaProg.uTinyMceIcons -Version 1.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="AreaProg.uTinyMceIcons" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add AreaProg.uTinyMceIcons --version 1.0.0
#r "nuget: AreaProg.uTinyMceIcons, 1.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install AreaProg.uTinyMceIcons as a Cake Addin
#addin nuget:?package=AreaProg.uTinyMceIcons&version=1.0.0

// Install AreaProg.uTinyMceIcons as a Cake Tool
#tool nuget:?package=AreaProg.uTinyMceIcons&version=1.0.0

Introduction

uTinyMce installs a tinymce plugin allowing editors to insert font awesome 4.2 icons in Umbraco rich text editor.

Complete documentation

The complete documentation can be found at https://github.com/ssougnez/uTinyMceIcons

Features

  • Add a button in the tinymce toolbar to add an font awesome icon.
  • Search for the icon to insert in a list.
  • Add the icon with a fixed width.
  • Change the size of the icon.
  • Add a spinning animation to the icon.
  • An inserted icon can be edited afterwards.

Planner features

  • Umbraco 7.13 ships with font awesome 4.7, so this plugin will be updated to take the new icons into account as soon as Umbraco 7.13 is released.

Compatibility

Even though this plugin has been developed with Umbraco 7.12, it is usable from the version 7.5.0 (with some quirks). This plugin has been tested with Umbraco 7.2.0 and it was not supported. Version 7.3.0 and 7.4.0 haven't been tested but they are not officially supported (it does not mean that it won't work).

Troubleshoot

I don't see the icon in the toolbar

The icon doesn't magically appear, your RTE datatype must be edited to allow the uTinyMceIcon button to appear. See Umbraco documentation to learn how to do so.

I can't select an icon in the RTE using Umbraco < 7.12

If you can't select an icon in the RTE by clicking on it, you should be able to do so by double-clicking on it. If the caret disappears, then it means that the icon is selected and you can click the toolbar item to edit the icon.

It does not work correctly

uTinyMceIcons depends on the "noneditable" plugin to work as expected. If you didn't configure this plugin, it should be configured automatically during the installation, however, if you already configured it, you might need to perform a manual action to make uTinyMceIcons behave as expect.

  • Open the file config/tinyMceConfig.config
  • Locate a custom config called "noneditable_noneditable_class"
  • This config contains a space separated list of class names made non editable by the plugin. Ensure that the class "fa" is included.

The whole configuration added in this file is the following:

  • tinymceConfig/commands
<command>
  <umbracoAlias>uTinyMceIcons</umbracoAlias>
  <icon>images/editor/flag.gif</icon>
  <name>Icon</name>
  <tinyMceCommand value="" userInterface="false" frontendCommand="uTinyMceIcons">uTinyMceIcons</tinyMceCommand>
  <priority>100</priority>
</command>
  • tinymceConfig/plugins
<plugin loadOnFrontend="true">noneditable</plugin>
<plugin loadOnFrontend="true">uTinyMceIcons</plugin>
  • tinymceConfig/customConfig
<config key="noneditable_noneditable_class">fa</config>

I have another issue

If you have another issue preventing uTinyMceIcons to work correctly, please post a new issue on the github page.

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.2.1 1,279 11/15/2018
1.0.3 969 11/20/2018
1.0.2 829 11/16/2018
1.0.1 710 11/15/2018
1.0.0 673 11/15/2018