Создание шаблона SiteCore для вставки JavaScript

Я пытаюсь создать базовое решение для управления тегами в SiteCore.

Я создал папку Управление тегами в разделе Шаблоны. В папке «Управление тегами» я создал шаблон под названием Google Analytics. Этот тег имеет несколько атрибутов, которые используются в качестве параметров тега.

Если я создам элемент контента, который наследует этот шаблон, я увижу поля атрибутов.

Что мне нужно знать, так это то, где — в качестве наилучшей практики — я бы написал свой код, который генерирует тег script. Я просмотрел исходный проект SiteCore и не вижу папок для кода шаблона.


ОБНОВЛЕНИЕ: На основании отзывов и этого URL: http://andyuzick.arke.com/2013/02/as-web-marketers-great-deal-of-our.html , я реализовал новую библиотеку классов с последующий:

Settings.cs

namespace TagManagement
{
    public class Settings
    {
        public const string DEFAULT_GLOBAL_TAG_FOLDER = "/sitecore/content/Global/TagManagement";
        public static string GlobalTagFolder
        {
            get
            {
                return Sitecore.Configuration.Settings.GetSetting("TagManagement.GlobalTagFolder", DEFAULT_GLOBAL_TAG_FOLDER);
            }
        }
    }
}

WebControl.cs

using Sitecore.Data.Items;
using Sitecore.Diagnostics;
using System;
using System.Text;
using System.Web.UI;

namespace TagManagement
{
    public class TagManagmentControl: Sitecore.Web.UI.WebControl
    {
        System.Web.UI.WebControls.Literal container;

        public string TagItem { get; set; }

        protected override void OnInit(EventArgs e)
        {
            base.OnInit(e);
            container = new System.Web.UI.WebControls.Literal();
        }

        protected override void CreateChildControls()
        {
            Assert.IsNotNullOrEmpty(TagItem, "tag item");
            Item item = Sitecore.Context.Database.GetItem(TagItem);
            StringBuilder tagToOutput = new StringBuilder();
            string templateName = item.TemplateName;
            switch (templateName)
            {
                case "Google Analytics":
                    tagToOutput.AppendLine("<script>");
                    tagToOutput.AppendLine("    (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){");
                    tagToOutput.AppendLine("    (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),");
                    tagToOutput.AppendLine("    m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)");
                    tagToOutput.AppendLine("    })(window,document,'script','//www.google-analytics.com/analytics.js','ga');");
                    tagToOutput.AppendLine("    ga('create', '" + item.Fields["Tracking ID"].Value + "', '" + item.Fields["Domain"].Value + "');");
                    if (item.Fields["Enable Demographics and Interest Reports"].Value == "1") 
                    {
                        tagToOutput.AppendLine("    ga('require', 'displayfeatures');");
                    }
                    tagToOutput.AppendLine("    ga('send', 'pageview');");
                    tagToOutput.AppendLine("</script>");
                    tagToOutput.AppendLine();
                    break;
                case "HTML Tracking Tag":
                    tagToOutput.AppendLine(item.Fields["Markup"].Value);
                    break;
            }
            container.Text = tagToOutput.ToString();
        }

        protected override void DoRender(HtmlTextWriter output)
        {
            EnsureChildControls();
            container.RenderControl(output);
        }

        protected override string GetCachingID()
        {
            return this.GetType().FullName;
        }
    }

}

PipelineProcessor.cs

using Sitecore.Data.Items;
using Sitecore.Diagnostics;
using Sitecore.Layouts;
using Sitecore.Pipelines.InsertRenderings;

namespace TagManagement
{
    public class InsertTags
    {
        public void Process(InsertRenderingsArgs args)
        {
            Assert.ArgumentNotNull(args, "args");

            if (Sitecore.Context.Site.Name == "shell")
            {
                return;
            }

            Item globalTagFolder = Sitecore.Context.Database.GetItem(Settings.GlobalTagFolder);
            Profiler.StartOperation("Tag Management: Adding Tags...");

            foreach (Item globalTagItem in globalTagFolder.Children)
            {
                TagManagement.TagManagmentControl control = new TagManagement.TagManagmentControl();
                if (control != null)
                {
                    control.TagItem = globalTagItem.ID.ToGuid().ToString();
                    control.Cacheable = true;
                    control.VaryByData = true;
                    RenderingReference reference = new RenderingReference(control);
                    reference.AddToFormIfUnused = true;
                    args.Renderings.Add(reference);
                    Tracer.Info(string.Concat("Tag Management: Added: '", globalTagItem.Name, "'"));
                }
            }

            Profiler.EndOperation();
        }
    }
}

Буду признателен за любые конструктивные отзывы от экспертов SiteCore в зале!


person eat-sleep-code    schedule 03.04.2014    source источник


Ответы (1)


Я считаю, что вы в значительной степени в правильном направлении.

Я могу придумать три способа отобразить содержимое этих тегов.

1) Добавьте его в свой основной код макета (это самый простой, но мне действительно не нравится этот вариант, ваш код будет зависеть от основного макета)

2) Создайте подмакет и добавьте его в определенный заполнитель в вашем теге заголовка, дайте коду подмакета ответственность за отображение тегов (тоже не слишком это нравится)

3) Создайте процесс в конвейере «renderLayout», который сделает всю работу за вас (лучший вариант, он не связан и может легко включаться и выключаться через конфигурационные файлы) * Предостережение: ваш тег должен быть запущен на сервере.

Вот как будет выглядеть ваш процесс:

namespace YourNamespace
{
    public class PrintTags
    {
        public void Process(RenderLayoutArgs args)
        {
            //put here validation you may require

            var head = WebUtil.FindControlOfType(Sitecore.Context.Page.Page, typeof(System.Web.UI.HtmlControls.HtmlHead));

            if (head != null)
            {
                //add any content in the head
                head.Controls.Add(new Literal(" CONTENT "));
            }
            else
            {
                //make sure to not break the app instead just log the error.
                Sitecore.Diagnostics.Log.Error("Error - The HEAD element must be runat=server", this);
            }
        }
    }
}

.Конфигурация:

<configuration>
  <sitecore>
    <pipelines>
      <renderLayout>
        <processor type="YourNamespace.PrintTags, YourAssembly" />
      </renderLayout>
    </pipelines>
  </sitecore>
</configuration>

Надеюсь, поможет..

ваше здоровье

person RobertoBr    schedule 03.04.2014