15

I've been playing with SXA and some of the out of the box renderings and rendering variants that come with it. I understand how to create my own rendering variants, and I understand how to create my own renderings in a traditional Sitecore sense. That said, what I can't quite come around to figuring out is how to create new renderings that are peers with those of SXA.

So, what I'm trying to understand is:

  • How do I create new, SXA-enabled components that can be used by my content editors from the toolbar?
  • What considerations do I need to take in to account to make rendering variants for my new rendering?
  • How should I set this up in a solution to stay adherent to Helix principles?

Any guidance on these or reading would be helpful; I haven't found much in the SXA documentation.

12

This is what I worked out from playing with SxA:

  • For your controller renderings, you need to make sure your controller inherits from Sitecore.XA.Foundation.Mvc.Controllers.StandardController

  • Make sure your rendering has a rendering parameters template setup. If you inherit from /sitecore/templates/Foundation/Experience Accelerator/Rendering Variants/Rendering Parameters/IComponentVariant and /sitecore/templates/Foundation/Experience Accelerator/Presentation/Rendering Parameters/IStyling you will get the variant and styling options added to the properties of the rendering parameters.

  • Finally make sure your component is added to the available renderings for your site's presentation:

    enter image description here

  • Did you have to create any items under System or Templates that follow the Helix pattern? – Michael West Oct 27 '16 at 14:18
  • 6
    I created the rendering parameters template under /sitecore/templates/Feature/mycomponent/Rendering Parameters - I don't know if it must follow the Helix pattern tho, I just did. – Richard Seal Oct 27 '16 at 14:19
  • 1
    This is fantastic Richard, thank you. I'm unable to get to my SXA instance today, but I wanted to confirm: are your renderings showing up in the SXA toolbar? Did inheriting from one of the SXA template interfaces enable that? Thanks! – Derek C Oct 27 '16 at 14:35
  • 4
    You need to add your rendering into so called Available renderings (you can see it on the screenshot). Those items defines which renderings should be visible in the Toolbox – Alan Płócieniak Oct 27 '16 at 14:44
  • Yes, of course. Apologies, coffee has not set in yet. Thanks, Richard and Alan. – Derek C Oct 27 '16 at 14:53

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.