The UrlValidator under Litium.Studio.Plugins has been obsoleted. The new UrlValidator is in Litium.Web namespace. The purpose of the validator is to validate the url path for pages, categories and products. This is to ensure that they contain only approved characters that can be used without encoding problems when linking to the content.
/// <summary>
/// Url validator is used to validate that url has a known good format.
/// </summary>
[Service(ServiceType = typeof(UrlValidator))]
[RequireServiceImplementation]
public abstract class UrlValidator
{
/// <summary>
/// Validates the url.
/// </summary>
/// <param name="cultureInfo">The culture info for the url.</param>
/// <param name="url">The url to validate.</param>
/// <returns><see cref="UrlValidatorResult"/> with the result of the validation.</returns>
public abstract UrlValidatorResult Validate([NotNull] CultureInfo cultureInfo, [NotNull] string url);
}
- UrlValidatorImpl is the default implementation of the UrlValidator, which is based on UrlValidatorConfig to perfom the check for invalid characters and invalid words for a given url.
- UrlValidatorConfig class has these three collections for invalid characters, words and extensions:
public static ISet<char> DefaultInvalidCharacters { get; } = new ReadOnlyHashSet<char>(
"/\\.,;: +*'§½\"<>|!?$&=@#%{}^~[]`´¨¤—–‘’“”\t\r\n".ToCharArray()
.Concat(new[] { '\u2007', '\u00A0', '\u0020', '\u202F', '\u2060', '\uFEFF' }));
/// <summary>
/// Default invalid characters contains all the characters that is configured by the solution to be invalid for urls.
/// </summary>
public static ISet<string> DefaultInvalidWords { get; } = new ReadOnlyHashSet<string>(new[] {
"Litium",
"Site",
"Bin",
"App_Code",
"App_Data",
"App_GlobalResource",
"App_LocalResource",
"App_WebResource",
"App_Browsers",
"Theme",
"storage"
}, StringComparer.OrdinalIgnoreCase);
/// <summary>
/// Default file extensions that is invalid to have in url's.
/// </summary>
public static ISet<string> DefaultInvalidExtensions { get; } = new ReadOnlyHashSet<string>(new[] {
".ico",
".axd",
".axms",
".ashx",
".aspx",
".svc"
}, StringComparer.OrdinalIgnoreCase);
There are three more collections to add new exclusions to the default collections above: InvalidCharacters, InvalidWords, InvalidExtensions.
The UrlValidatior can be used anywhere to validate urls, currently in Litium it is used in url validation rules for Base Product, Category, Variant, DraftPage and Page.