Skip to content

Latest commit

 

History

History
34 lines (22 loc) · 2.6 KB

page-builder.md

File metadata and controls

34 lines (22 loc) · 2.6 KB

Page Builder Developer Docs

We built Page Builder to work with just about any WordPress theme, but there are lots of things you can do to customize the experience for your users. Please read our Contributing to Page Builder guide if you'd like to help improve Page Builder.

Widgets

Page Builder supports most standard widgets. There are a few things that you should be aware of though. Especially related to how your widget should handle Javascript. Read our compatibility guide on making your widgets work with Page Builder.

There are a few ways that you can either register widgets that only appear in widgets area or Page Builder.

Page Builder has a few unique widget related concepts.

  • Placeholder widgets let you add widgets that don't yet exist to the Add Widget dialog. This feature is useful for recommending widgets that you might want your user to install. You can also remove the widgets that Page Builder itself recommends.
  • Widget groups let you organize your widgets within the Add Widget dialog.
  • Widget icons let you make your widgets stand out in the Add Widget dialog.

For widget developers, you could consider using the SiteOrigin Widgets Bundle as a boilerplate for your widgets. It gives you a base to create some fairly advanced widgets and widget interfaces with minimal coding.

Prebuilt Layouts

Prebuilt Layouts are a great way to give your users some designs that they can use with your theme. A prebuilt layout is essentially a complete layout that your users can insert. Read our guide on bundling prebuilt layouts for your pages.

Hooks and Filters

Page Builder has lots of hooks and filters for you to use. We've already covered these briefly in the Widgets and Prebuilt Layouts sections, but there are other filters you can use to inject custom content, filter output, etc.