16

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.

Improve this question

1 Answer 1

Reset to default
13

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

Improve this answer
7
  • Did you have to create any items under System or Templates that follow the Helix pattern?
    – Michael West
    Oct 27, 2016 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, 2016 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, 2016 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, 2016 at 14:44
  • Yes, of course. Apologies, coffee has not set in yet. Thanks, Richard and Alan.
    – Derek C
    Oct 27, 2016 at 14:53

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

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