Insert plain text (or image) anywhere in Discourse


(Daniela) #1

So, you want insert some text or image in your Discourse site.

Regarding the text in most cases it is sufficient to modify it from /admin/customize/site_texts.
Sometimes, however, it is our desire to add a sentence between two distinct blocks, rather than modifying one of the existing elements.

Let’s see how to do it using the property :before and :after in CSS3.

Basic steps

  1. In order to work we will need to use the developer console present on the main browsers. To open it, just press F12.

  2. Select the element where, before or after, you want to add text.


    As you can see every time the mouse passes on an element it will be highlighted and the corresponding class will be automatically selected on Html and CSS on the right. Before editing the Discourse stylesheet, do a live test, so after choosing the element on which to operate just click the :heavy_plus_sign: icon. These will add a new rule to the CSS that we can modify according to our needs.

  3. Start to edit. Add the suffix :before or :after to the class and add a text using the content property.
    Adding an image is a bit more complicated if you do not know the CSS, but it is good practice to follow a similar pattern:

    background-image: url(url-goes-here);
    background-repeat: no-repeat;
    background-size: your-value;
    content: ""
    width: your-value;
    height: your-value;
    display: inline-block 
    

    Before:


    and after:

    Remember that the text will appear wherever the specific class you have selected is used. Sometimes you need to specify on which element you want the new text to appear, adding the parent element to the CSS.

  4. Customize it. Knowing a bit about CSS it is easy to customize the style of the text as you want.

    .fancy-title::after {
         content: "ANOTHER TEXT ""\f072";
         color: violet;
         font-family: Fontawesome;
         background: linear-gradient(to right, #7ce5df 27%,#f1da36 100%);
         font-size: 18px;
         padding: 2px 4px;
         border: 1px solid;
     }
    
  5. Once satisfied, add your changes to the CSS of your site by creating a theme component


We proceed with some practical examples

  • Topic Title
    For some sites it may be useful to add an image, a banner or a personalized advertisement before or after the title or each post.

    #topic-title::before {
      background-image: url(your-URL-here);
      background-repeat: no-repeat;
      background-size: 750px 335px;
      width: 750px;
      height: 335px;
      display: inline-block;
      content: "";
    }
    
    #topic-title::after {
      background-image: url(your-URL-here);
      background-repeat: no-repeat;
      background-size: 800px 295px;
      width: 800px;
      height: 295px;
      display: inline-block;
      content: "";
    }
    
  • Topic Body

      .topic-body.clearfix::before {
          background-image: url(your-URL-here);
          max-height: 2.8571em;
          width: 690px;
          height: 184px;
          background-size: auto 2.8571em;
          background-repeat: no-repeat;
          margin-left: 11px;
          margin-bottom: 0.25em;
      }
    

    or after


    Just change .topic-body.clearfix::before to .topic-body.clearfix::after
    In the same way is it possible add a plain text before or after:

    .topic-body.clearfix::before  { 
      content: "DISCOURSE ROCKS!";
      color: red;
      font-weight: bold;
      padding-left: 11px;
     }
    

  • Post Buttons


    .nav.post-controls .actions::before {
      color: red;
      content: "Hello from Discourse";
    

    }

  • Timeline

    .topic-timeline::before {
      color: red;
      content: "Hello World";
    }
    
    .topic-timeline::after {
      color: red;
      content: "Hello again";
    }
    
    .timeline-scroller-content::before {
      color: violet;
      content: "Hey,";
    }
    
     .timeline-scroller-content::after {
      color: violet;
      content: "It's me again!";
    }
    
    .timeline-container .topic-timeline .start-date::before {
      color: goldenrod;
      content: "Start Date ";
    }
    
    timeline-container .topic-timeline .start-date::after {
      color: goldenrod;
      content: " \f060";
      font-family: Fontawesome;
    }
    
    .widget-link.now-date::before {
      content: "\f061 ";
      color: burlywood;
      font-family: Fontawesome;
    }
    
    .widget-link.now-date::after {
      color: burlywood;
      content: " Now Date";
    }
    
  • Footer Buttons

    #topic-footer-buttons::before {
      content: "THESE ARE FOOTER BUTTONS";
      color: indianred;
      border: 2px solid;
      padding: 3px;
    }
    
    #topic-footer-buttons::after {
      color: indianred;
      content: "CONTENT AFTER GO HERE";
      border: 2px solid;
    }
    

    In the latter case it should be noted that the :after content is inserted after a text. If you do not need special customizations in this case it is advisable to change the original text via /admin/customize/site_texts instead of editing the CSS.

  • Suggested Topics

    #suggested-topics::before {
      content: "";
      background-image: url(https://meta-s3-cdn.freetls.fastly.net/original/3X/1/0/101f03af29f12ea30e1226eb96a02c3ed2f6d2ef.png);
      width: 690px;
      height: 184px;
      background-size: 690px 184px;
      background-repeat: no-repeat;
      display: inline-block;
    }
    
    
    #suggested-topics::after {
      content: "";
      background-image: url(https://meta-s3-cdn.freetls.fastly.net/original/3X/1/0/101f03af29f12ea30e1226eb96a02c3ed2f6d2ef.png);
      width: 690px;
      height: 184px;
      background-size: 690px 184px;
      background-repeat: no-repeat;
      display: inline-block;
    }
    

Ref: Insert text (disclaimer) anywhere in Discourse


(Mittineague) #4

A possible “gotcha” to keep in mind:

Note: The pseudo-elements generated by ::before and ::after are contained by the element’s formatting box, and thus don’t apply to replaced elements such as <img> , or to <br> elements.

In other words, it won’t work for “self closed” elements that can’t have child elements. It is intuitive to think the pseudo-elements are like:

{::before is here}<tag>text content</tag>{::after is here}

when in reality it is

<tag>{::before is here}text content{::after is here}</tag>