I want to highlight the option to subscribe to a post, thread, or board with a button (instead of having it hidden in the options menu). Does anyone already have code to do that? Thanks,Jonathan

Hi Jonathan, Depending on your requirements, you may be able to leverage the standard components for your purposes. The components just display as links, but if you wanted to you could create a custom component, insert the component(s) using the <@component> FreeMarker macro, wrap the component with your own HTML and style as needed. Here are the subscription-related components for a thread: <component id="subscriptions.action.remove-thread-user-float" /> <component id="subscriptions.action.add-thread-user-float" /> <component id="subscriptions.action.remove-thread-user-bookmark" /> <component id="subscriptions.action.add-thread-user-bookmark" /> <component id="subscriptions.action.remove-thread-user-email" /> <component id="subscriptions.action.add-thread-user-email" /> and for a message: <component id="subscriptions.action.remove-message-user-float" /> <component id="subscriptions.action.add-message-user-float" /> <component id="subscriptions.action.remove-message-user-bookmark" /> <component id="subscriptions.action.add-message-user-bookmark" /> <component id="subscriptions.action.remove-message-user-email" /> <component id="subscriptions.action.add-message-user-email" /> You'll likely be interested in the "email" ones, but I provided the others just in case. You'll want to make sure you only use these components on pages where they're going to have the appropriate thread/message context (ie. a ForumMessage page) Alternately, you could use the REST API to add/remove the subscriptions, but that's probably going to be quite a bit more complex. Let me know if you'd prefer to go down that route, and I can provide some additional details to get you started. I hope this helps!

Not to disagree with Doug, but I would suggest a differenty way. First, you can add to the menu but not the menu bar. Adding subscribe to the menu is unnecessary as it is already there. The menu bar is not editable by any means. Second, here is how I would acheive what you are looking for. 1) Add your new component directly above the menbar component. In this example, my custom component is called "custom-add-to-my-places" 2) Add css to float the custom component and the menu bar to the left. You may need to adjust the width of menu bar: .lia-component-custom-add-to-my-places { float: left; } .lia-menu-bar-top { float: left; width: 97%; } 3) You now have the look of the two items living in the same line. In my case, I styled the subscription as a "favorites" heart to acheive an all icon look:

Hey Lainie, We have a way to place items in the menu bar, but it's in an XML file that we don't expose a way to edit through Studio, so someone in our Professional Services group would need to add this for you. We hope to make it self service at some point in the future. The only way I can think of to do it without Services would be to insert it into the menu bar using Javascript, although that could cause a slight delay before the subscription buttons show up. -Doug

I believe the component id for the component that subscribes the current user to a message is "subscriptions.action.add-message-user-email", so you could try adding that inside a custom component using the @component directive: <@component id="subscriptions.action.add-message-user-email" /> It needs to be in the context of the message you want the user to subscribe to, so you would need to add it to a component that you've placed inside the appropariate "message quilt" (if this is for a forum board, it needs to be in a component that is placed inside the ForumMessage quilt, if it's for a blog board it needs to be in a component that is placed inside the BlogMessage quilt, etc.). If you add it there, you will probably also need to add some CSS to style it to look like a button instead of a link in the post options menu drop-down. I'm not sure if anyone has tried doing this before, so ymmv. The other options would be to roll your own subscription component using the REST API call for subscibing the current user to a given message. If you are trying to add a link/button to subscribe the current user to an entire thread, that uses the "subscriptions.action.add-thread-user-email" component (use <@component id="subscriptions.action.add-thread-user-email" />) and you'll need to place the @component directive in a custom component that is in a "thread page quilt" (ForumTopicPage, BlogArticlePage, IdeaPage, etc.) or else roll your own logic to subscribe the current user to the thread, using the REST API call for subscribing the current user to a given thread. If you are trying to add the link/button to subscribe the current user to a board, that uses the "subscriptions.action.remove-board-user-email" component(use <@component id="subscriptions.action.remove-board-user-email" />) and you'd need to place the @component directive in a custom compoennt that is in a "board page quilt" (ForumPage, BlogPage, IdeaExchangePage, etc.) or else roll your own logic to subscribe the current user to the board, using the REST API call for subscribing the current user to a given board. I hope that helps! -Doug

Nevermind. Found it. Just replaced 'message' or 'thread' with 'board'. Thanks!

Subscribe Button

AdamN
Khoros Oracle
12 years ago
Hi Jonathan,

Depending on your requirements, you may be able to leverage the standard components for your purposes. The components just display as links, but if you wanted to you could create a custom component, insert the component(s) using the <@component> FreeMarker macro, wrap the component with your own HTML and style as needed.

Here are the subscription-related components for a thread:

<component id="subscriptions.action.remove-thread-user-float" /> <component id="subscriptions.action.add-thread-user-float" /> <component id="subscriptions.action.remove-thread-user-bookmark" /> <component id="subscriptions.action.add-thread-user-bookmark" /> <component id="subscriptions.action.remove-thread-user-email" /> <component id="subscriptions.action.add-thread-user-email" />

and for a message:

<component id="subscriptions.action.remove-message-user-float" /> <component id="subscriptions.action.add-message-user-float" /> <component id="subscriptions.action.remove-message-user-bookmark" /> <component id="subscriptions.action.add-message-user-bookmark" /> <component id="subscriptions.action.remove-message-user-email" /> <component id="subscriptions.action.add-message-user-email" />

You'll likely be interested in the "email" ones, but I provided the others just in case. You'll want to make sure you only use these components on pages where they're going to have the appropriate thread/message context (ie. a ForumMessage page)

Alternately, you could use the REST API to add/remove the subscriptions, but that's probably going to be quite a bit more complex. Let me know if you'd prefer to go down that route, and I can provide some additional details to get you started.

I hope this helps!
- skveerkamp
  Ace
  8 years ago
  Thank you so much for posting! We've been desperately needing this as most users cannot find the subscription button under "page options." I'm not an engineer, so I'm not able to use the Lithium SDK with any amount of confidence. Greatly appreciated!
  - jjeremiah
    Expert
    7 years ago
    I've been following this thread and haven't yet got this to work.
    
    Same issue / question - we want to make it easy for a user to subscribe to the message or perhaps the thread.
    
    I've explored using the API... but consistently get a 501 errorr code when I use the POST method.
    
    For example:
    <form action="https://community.xxx.com/restapi/vc/boards/id/tips_and_tricks /subscriptions/users/self/add/email" method="post"><input type="submit"> </form>
    <response status="error">
    <error code="501">
    <message>
    Unknown path element at node 'node_subscription_context.users.self.add'.
    </message>
    </error>
    </response>
    I get the same result for:
    <form action="https://community.xxx.com/restapi/vc/threads/id/1615100/subscriptions/users/self/add/email" method="post"><input type="submit"> </form>
    
    Any ideas or feedback?
    
    Thanks
    
    John
- LainieH
  Expert
  9 years ago
  AdamN this was extremely helpful. I'm 1/2 way there - I created the custom component, added the OOTB component code, wrapped a little HTML around it and even added a couple of CSS styles. cjdinger refined it.. but we're missing one thing.
  
  We want to add the Subsribe button for a board within the
  "lia-menu-bar lia-menu-bar-top lia-component-menu-bar" class (vs. adding the button using a fixed position in CSS).
  
  Is this possible?
  
  Thank you, Lainie
  - matthew_d
    Mentor
    9 years ago
    Bump this post. LainieH did you ever find the answer to this? AdamN could you provide some additional support here? I have the same question.
- Inactive User
  11 years ago
  Is there a component like these for the email subscription from a board page? THanks
  - Inactive User
    11 years ago
    Nevermind. Found it. Just replaced 'message' or 'thread' with 'board'. Thanks!