Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/geta/tags
Geta Tags for EPiServer CMS
https://github.com/geta/tags
cms episerver
Last synced: about 2 months ago
JSON representation
Geta Tags for EPiServer CMS
- Host: GitHub
- URL: https://github.com/geta/tags
- Owner: Geta
- License: apache-2.0
- Created: 2012-09-30T15:49:12.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2023-01-19T17:09:42.000Z (about 2 years ago)
- Last Synced: 2023-04-10T16:50:58.977Z (almost 2 years ago)
- Topics: cms, episerver
- Language: C#
- Size: 51.3 MB
- Stars: 20
- Watchers: 32
- Forks: 34
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Geta Tags for EPiServer
* Master
,branch:master/statusIcon)
[](https://msdn.microsoft.com/en-us/library/w0x726c2%28v=vs.110%29.aspx)
[](http://world.episerver.com/cms/)
## Optimizely CMS12?
Looking for for Optimizely CMS12 supprot? We slightly changed the name of the package. Head [over there](https://github.com/Geta/geta-optimizely-tags) for more information.
## Description
Geta Tags is a library that adds tagging functionality to EPiServer content.
## Features
- Define tag properties
- Query for data
- Admin page for managing tags
- Tags maintenance schedule job
See the [editor guide](docs/editor-guide.md) for more information.
## How to get started?
Start by installing NuGet package (use [EPiServer NuGet](http://nuget.episerver.com/)):
Install-Package Geta.Tags
The latest version is compiled for .NET 4.6.1 and EPiServer 11.
Geta Tags library uses [tag-it](https://github.com/aehlke/tag-it) jQuery UI plugin for selecting tags.
To add Tags as a new property to your page types you need to use the UIHint attribute like in this example:
```csharp
[UIHint("Tags")]
public virtual string Tags { get; set; }
[TagsGroupKey("mykey")]
[UIHint("Tags")]
public virtual string Tags { get; set; }
[CultureSpecific]
[UIHint("Tags")]
public virtual string Tags { get; set; }
```
Use ITagEngine to query for data:
```csharp
IEnumerable GetContentByTag(string tagName);
IEnumerable GetContentsByTag(Tag tag);
IEnumerable GetContentsByTag(string tagName, ContentReference rootContentReference);
IEnumerable GetContentsByTag(Tag tag, ContentReference rootContentReference);
IEnumerable GetContentReferencesByTags(string tagNames);
IEnumerable GetContentReferencesByTags(IEnumerable tags);
IEnumerable GetContentReferencesByTags(string tagNames, ContentReference rootContentReference);
IEnumerable GetContentReferencesByTags(IEnumerable tags, ContentReference rootContentReference);
```
## Customize Tag-it behaviour
You can customize the [Tag-it.js](https://github.com/aehlke/tag-it) settings by using the GetaTagsAttribute.
The following settings can currently be customized
- allowSpaces - defaults to **false**
- allowDuplicates - defaults to **false**
- caseSensitive - defaults to **true**
- readOnly - defaults to **false**
- tagLimit - defaults to **-1** (none)
```csharp
[CultureSpecific]
[UIHint("Tags")]
[GetaTags(AllowSpaces = true, AllowDuplicates = true, CaseSensitive = false, ReadOnly = true)]
public virtual string Tags { get; set; }
```
## Local development setup
See description in [shared repository](https://github.com/Geta/package-shared/blob/master/README.md#local-development-set-up) regarding how to setup local development environment.
### Docker hostnames
Instead of using the static IP addresses the following hostnames can be used out-of-the-box.
- http://tags.getalocaltest.me
## Package maintainer
https://github.com/patkleef
## Changelog
[Changelog](CHANGELOG.md)