Question

SDL Tridion’s Content Manager templating API (TOM.NET) offers ways to detect publishing or rendering context.

Use Cases

• Present debugging information to a specific environment (e.g. TCM Uris only on Staging)
• Show different markup in Preview (e.g. show a link to the published page)
• Show different author-able fields in Experience Manager or SiteEdit

I’ve seen and tried a few examples, but after following a chat between colleagues Stan and Eric, I want to make sure I follow for TOM.NET (6.1 / Tridion 2011).

Scenarios

1. Publishing to a specific Publication Target (typically “Live” and “Staging”)
2. Content Manager Explorer (CME) Preview
3. Session Preview rendering for Experience Manager (XPM)
4. (Added) Template Builder

1. Publishing to a Target (or from a Publication)

Tridion.ContentManager.Publishing.PublishEngine.GetPublishInfo(IdentifiableObject item)

Item would be a page or component. This returns a collection of PublishInfo objects, which includes PublicationTarget to confirm where you’re publishing to.

Tridion.ContentManager.Templating.PublishingContext.PublicationTarget has PublicationTarget as well.

2. CME Preview

PublicationTarget is null, which makes sense because you don’t have a Publication Target . 🙂

3. Session Preview

Use the RenderMode Enum under Tridion.ContentManager.Publishing, which has:

• ‘Publish’ (0)
• ‘PreviewStatic’ (1)
• ‘PreviewDynamic’ (2)

PublicationTarget wouldn’t be null for Session Preview, which isn’t really publishing.

4. (Added) Template Builder

?

Alexander Klock also describes some related examples which cover most of this except CME Preview.

Question(s)

• Am I missing any scenarios? Publish to a specific publication target, regular preview, and XPM session preview?

• How should I avoid hard-coding PublicationTargets (e.g. is it better to check the string values instead of TCM Uris)?

• Update: added Template Builder to the list per Vikas’s answer, how do I know I’m rendering within Template Builder?

Answer 1

You really need a tl;dr on this question…

Here’s what I know:

Template Builder

Publication target is null, RenderMode is PreviewDynamic

CME Preview

Publication Target ID is tcm:0-0-0 (or TcmUri.UriNull), RenderMode is PreviewDynamic

Session Preview

Publication Target ID is the real target ID, RenderMode is PreviewDynamic

Publish

Publication Target ID is the real one, RenderMode is Publish

EDIT

Here’s some sample code I wrote recently to determine the Current mode.

private CurrentMode GetCurrentMode()
{
    RenderMode renderMode = _engine.RenderMode;
    if (renderMode == RenderMode.Publish) return CurrentMode.Publish;


    if (renderMode == RenderMode.PreviewDynamic)
    {
        if (_engine.PublishingContext.PublicationTarget == null) return CurrentMode.TemplateBuilder;
        PublicationTarget target = _engine.PublishingContext.PublicationTarget;
        if (target.Id.Equals(TcmUri.UriNull)) return CurrentMode.CmePreview;
        return CurrentMode.SessionPreview;
    }
    return CurrentMode.Unknown;
}

private enum CurrentMode
{
    TemplateBuilder,
    CmePreview,
    SessionPreview,
    Publish,
    Unknown
}