readme.md

BG: Icon Picker

Icon picker for Umbraco 7.4.0+

Data Type that enables you to use your own website icon set in the backoffice.

---

Inspired by the Iconator package. Since the creator of that package doesn't respond to pull requests, I took matters into my own hands and redesigned it from the ground up with better functionality and styling.

---

Installation

NuGet

1. Install package through NuGet Package Manager

2. Create the data type

   Location: Developer > Data Types

3. Configure the newly created data type.

4. Use and enjoy.

Umbraco Package Section

1. Install the package

2. Configure the data type

   Location: Developer > Data Types > BG: Icon Picker

Configuring the Data Type:

Path to stylesheet: Stand-alone stylesheet for the icons is required.

/css/icons.min.css

Class name regex: It's recommended to not use "icon" as class identifier so it won't interfere with the umbraco icons.

(icn-[^:]*?):before

Icon pattern: "{0}" will be replaced with the icon regex.

<i class="{0}"></i>

Retrieving data from the icon picker:

The icon picker returns a string with the icon name so it's really simple to work with.

<i class="@Model.Content.GetPropertyValue<string>("icon")"></i>

Using ModelsBuilder?

Matthew-wise wrote up a converter for ModelsBuilder:

    [PropertyValueType(typeof(string))]
    public class BgIconPickerValueConverter : PropertyValueConverterBase
    {
        public override bool IsConverter(PublishedPropertyType propertyType)
        {
            return propertyType.PropertyEditorAlias.Equals("bgIconPicker");
        }
    }