Go to System → Plugins and search for "PX Editor".
Editor - PX Editor
| Option | Default | Meaning |
|---|---|---|
| Minimum height (px) | 350 | Smallest height of the writing area (150 to 1200). When the text is longer than three quarters of the window, the area scrolls and the toolbar stays on top. |
| Accent colour | Empty | Colour of active buttons, the Insert button and the focus ring. Empty follows the administrator template. |
| Show the credit line | Yes | Shows the product name in the bar below the editor. It is never written into your content. |
| Upload folder | Empty | Subfolder of the Media Manager image folder for dropped and pasted images, for example articles. Empty uses the image folder itself. |
| Store video posters locally | Yes | Copies the poster of YouTube and Vimeo videos into pxeditor/posters in the Media Manager. See Media, uploads and privacy. |
| Offer ready-made templates | Yes | Shows the 12 shipped templates in the Template panel. |
| Template category | None | Published articles of this category become shared templates. See Templates. |
Content - PX Editor
This plugin works on the public site and when an article is saved. It never changes the article text.
Main tab
| Option | Default | Meaning |
|---|---|---|
| Load on every page | No | Normally styles and script are loaded only on pages that contain PX Editor blocks. Turn it on when some content is shown without passing through content plugins (for example a template override that prints the intro text directly) and therefore lacks its styles. |
Post formats tab
Classifies articles by the media they contain, so that menus and modules can list "articles with video" or "articles with a gallery". Applied each time an article is saved.
| Option | Meaning |
|---|---|
| Tag for articles with video | Added when the article contains a video block (YouTube, Vimeo or a video file), removed when it no longer does. |
| Tag for articles with a gallery | The same for gallery blocks. |
| Tag for articles with audio | The same for audio players. |
| Post format field | An article custom field that receives one of four values: video, gallery, audio, standard (the most important medium of the article). |
Using the tags:
- Create tags in Content → Tags, for example "Video" and "Gallery".
- Choose them in the matching options and save the plugin.
- Create a menu item of type Tags → Tagged Items for the "Video" tag, or use the Articles module filtered by tag.
The plugin adds and removes only the tags chosen here; an article's other tags are never touched. Older articles are classified the next time they are saved.
Using the field: create a custom field of type List with exactly the four values video, gallery, audio, standard (or a Text field), then choose it in Post format field. It is useful for filters (such as PX Filter) and template overrides.
The PX Editor sample data selects its demo tags "Video" and "Gallery" in the first two options if they are empty. See Sample data.
Share buttons tab
| Option | Default | Meaning |
|---|---|---|
| Add to every article | No | Adds the buttons above, below, or both. Articles that contain a Share buttons block are skipped. |
| Buttons | All except Pinterest | Which networks get a button. |
| Style | Icons | Icons only, or icons with names. |
| Show the word "Share" | Yes | The label in front of the row. |
| Only in these categories | Empty (all categories) | Limits the automatic buttons. |
| Also in blog and featured lists | No | Shows the buttons under each article of a list. |
| Add Open Graph tags | Yes | Title, summary and image for shared links. Tags set by another extension are kept. |
Details in Front end.