Curator messages

georgina 2017-07-05 03:02:17 UTC #1

I'm looking at displaying a message when a search query matches a regular expression.

"Disaply an advert with a link" and "Display a simple message" will both work. However, I notice that by default "simple message" is displayed within a blockquote tag, where as the "advert" is marked up using an alert class.

Is there a reason for this difference?

Also, is it possible to use the search query inside a curator message?

gordongrace 2017-07-05 09:14:39 UTC #2

Hi @georgina -

I assume you're referring to the default simple form used to render results - the markup used for different curator actions there would best be regarded as suggested starting points that suit the majority of use cases, rather than hard-and-fast rules.

With some experimentation and minor editing of the corresponding Freemarker snippet, your Curator messages can be styled however you see fit, using whatever wrapping markup you'd like. The default snippets are shown below - note that you could swap out any of the HTML tags and classes as you see fit.

Example 1: if curator exhibits exist, and if there's message HTML to display, wrap it in a <blockquote> tag:

<#if (response.curator.exhibits)!?size &gt; 0>
          <#list response.curator.exhibits as exhibit>
            <#if exhibit.messageHtml??>
              <blockquote class="search-curator-message">
                <#noescape>${exhibit.messageHtml}</#noescape>
              </blockquote>
            </#if>
          </#list>
        </#if>

And for different curator actions:

<#assign curatorAdvertPresent = false />
        <#list response.curator.exhibits as exhibit>
            <#if exhibit.titleHtml?? && exhibit.linkUrl??>
                <#assign curatorAdvertPresent = true />
                <#break>
            </#if>
        </#list>

        <#if (response.resultPacket.bestBets)!?size &gt; 0 || curatorAdvertPresent >
          <ol id="search-best-bets" class="list-unstyled">
            <#-- Curator exhibits -->
            <#list response.curator.exhibits as exhibit>
              <#if exhibit.titleHtml?? && exhibit.linkUrl??>
                <li class="alert alert-warning">
                  <h4><a href="${exhibit.linkUrl}"><@s.boldicize><#noescape>${exhibit.titleHtml}</#noescape></@s.boldicize></a></h4>
                  <#if exhibit.displayUrl??><cite class="text-success">${exhibit.displayUrl}</cite></#if>
                  <#if exhibit.descriptionHtml??><p><@s.boldicize><#noescape>${exhibit.descriptionHtml}</#noescape></@s.boldicize></p></#if>
                </li>
              </#if>
            </#list>
            <#-- Old-style best bets -->
            <@s.BestBets>
              <li class="alert alert-warning">
                <#if s.bb.title??><h4><a href="${s.bb.clickTrackingUrl}"><@s.boldicize>${s.bb.title}</@s.boldicize></a></h4></#if>
                <#if s.bb.title??><cite class="text-success">${s.bb.link}</cite></#if>
                <#if s.bb.description??><p><@s.boldicize><#noescape>${s.bb.description}</#noescape></@s.boldicize></p></#if>
                <#if ! s.bb.title??><p><strong>${s.bb.trigger}:</strong> <a href="${s.bb.link}">${s.bb.link}</a></#if>
              </li>
            </@s.BestBets>
          </ol>
        </#if>