Uncategorized

The goal of this new editor is to make adding rich content to WordPress simple and enjoyable. This whole post is composed of pieces of content—somewhat similar to LEGO bricks—that you can move around and interact with. Move your cursor around and you’ll notice the different blocks light up with outlines and arrows. Press the arrows to reposition blocks quickly, without fearing about losing things in the process of copying and pasting.

What you are reading now is a text block the most basic block of all. The text block has its own controls to be moved freely around the post…

… like this one, which is right aligned.

Headings are separate blocks as well, which helps with the outline and organization of your content.

A Picture is Worth a Thousand Words

Handling images and media with the utmost care is a primary focus of the new editor. Hopefully, you’ll find aspects of adding captions or going full-width with your pictures much easier and robust than before.

Try selecting and removing or editing the caption, now you don’t have to be careful about selecting the image or other text by mistake and ruining the presentation.

The Inserter Tool

Imagine everything that WordPress can do is available to you quickly and in the same place on the interface. No need to figure out HTML tags, classes, or remember complicated shortcode syntax. That’s the spirit behind the inserter—the (+) button you’ll see around the editor—which allows you to browse all available content blocks and add them into your post. Plugins and themes are able to register their own, opening up all sort of possibilities for rich editing and publishing.

Go give it a try, you may discover things WordPress can already add into your posts that you didn’t know about. Here’s a short list of what you can currently find there:

---

Visual Editing

A huge benefit of blocks is that you can edit them in place and manipulate your content directly. Instead of having fields for editing things like the source of a quote, or the text of a button, you can directly change the content. Try editing the following quote:

The information corresponding to the source of the quote is a separate text field, similar to captions under images, so the structure of the quote is protected even if you select, modify, or remove the source. It’s always easy to add it back.

Blocks can be anything you need. For instance, you may want to add a subdued quote as part of the composition of your text, or you may prefer to display a giant stylized one. All of these options are available in the inserter.

You can change the amount of columns in your galleries by dragging a slider in the block inspector in the sidebar.

Media Rich

If you combine the new wide and full-wide alignments with galleries, you can create a very media rich layout, very quickly:

Sure, the full-wide image can be pretty big. But sometimes the image is worth it.

The above is a gallery with just two images. It’s an easier way to create visually appealing layouts, without having to deal with floats. You can also easily convert the gallery back to individual images again, by using the block switcher.

Any block can opt into these alignments. The embed block has them also, and is responsive out of the box:

You can build any block you like, static or dynamic, decorative or plain. Here’s a pullquote block:

Code is Poetry

The WordPress community

If you want to learn more about how to build additional blocks, or if you are interested in helping with the project, head over to the GitHub repository.

---

Thanks for testing Gutenberg!

👋

Adding post lists and grids to your Site couldn’t be easier than with the WP Show Posts plugin. Dispatch uses the Free version to display posts on the Front page and in the Sidebars. Of course with a little Flint Skin CSS treatment.

Head off to Dashboard > WP Show Posts > All Lists. Within are six lists:

• Align
• Standard
• Sidebar
• Header
• Simple
• Simple Sidebar

Each of them have very particular settings required to match the demo content you see here. Changing those settings may affect the way the post is displayed, and not necessarily for the better. So please work on a duplicate or make a note before changing.

Note: the name of the List has no relevance to the different styles displayed.

General ( and important ) information

Before we go into the detail let’s cover some basic and very important information.

Advanced Settings

For the purpose of the demo content a couple of the Lists are using Advanced Settings. First off the Standard List is using Ascending Order (Default: Descending).  Secondly the Simple List is using Offset, so it omits the first 4 posts. You may want to put these back to default if you’re not intending to replace them.

Duplicating WP Show Posts List

So we have four lists, and we want to make a new Standard list with a different category. The easiest way is to use one of the Duplicate Post plugins in the WordPress repository. Simple hey. And it works for all post types including GP Elements. Awesome. Note: When making a duplicate you are generally given two options. Clone and New Draft. I advise using the New Draft as some people have reported issues when using Clone.

 

List: Standard

This is the standard WP Show Post list that has the same custom styling applied to the GP Blog:

[wp_show_posts id=”1275″]

This is how the list is displayed within the Content area just by adding the WP Show Post Shortcode. Here follows the basic styling changes that have been made.

Content Wrap (WPSP Only)

Using a custom Hook Element the Post article content is now wrapped within a DIV container. This container carries a class of wpsp-content-wrap for styling. This wrap is present on all WP Show Posts that are output inside Dispatch.

Featured Image

The featured image has a fixed height to match the layout. This is achieved using this CSS:

.generate-columns-container article .inside-article img,  .wp-show-posts-image img {
    height: 180px;
    width: 100%;
    -o-object-fit: cover !important;
    object-fit: cover !important;
}

You can edit the height property to suit, or remove the CSS it entirely if you want to use your own sizes.

Meta above title

This is achieved using a flex box on the Entry Header. Again this applied to the GP Blog:

.generate-columns-container article .entry-header, .wp-show-posts-entry-header {
    display: -webkit-box;
    display: -ms-flexbox;
    display: flex;
    -webkit-box-orient: vertical;
    -webkit-box-direction: reverse;
    -ms-flex-direction: column-reverse;
    flex-direction: column-reverse;
}

Entry Title forced to 2 lines

The entry title always displays a minimum and maximum of 2 lines. This mantains the across row alignment. Again this is applied to GP Blog. The ex unit is used to define the number of lines visible. The lines are set by defining the line-height and setting the height to as many mutiples as you require lines. e.g up the height to 7.5ex will create three lines.

.generate-columns-container article .entry-header .entry-title, .wp-show-posts article .wp-show-posts-entry-title {
    line-height: 2.5ex;
    height: 5ex;
    overflow: hidden;
    text-overflow: ellipsis;
}

 

List: Align

Designed for a single column list this displays the content the image to the left and content to the right. This is subtly different to just resizing the image in the WP Show Posts list settings and aligning it left. Thanks to the Content Wrap we added (above) the content will never wrap around the image. On mobile it just stacks.

To add one of these your posts requires a little markup. And is done like so:

<div class="wpsp-align">shortcode_goes_here</div>

 

Lists: Sidebar

In the right had sidebar you can see the Sidebar list. This List is set to 1 column and only displays the Featured Image, Title and Category. This is designed for Widgets, a narrow column or as part of a grid (like in our next List).

To add this style the Widget requires a CSS Class of:

wpsp-card

Dispatch comes with Widget Classes Plugin installed. This provides this function.

 

List: Header

The Header list as seen on the Front Page requires a list containing only 5 posts. And can accomodate most of the content elements. Which are only displayed on the large leader post.

To add this style the Header Element requires the following element classes:

wpsp-grid wpsp-card

List: Simple

This is output using the wpsp-card inserted into a containing DIV like so:

<div class="wpsp-card">shortcode goes here</dib>

 

List: Simple Sidebar

Nothing fancy here,  just a list being output using the a Widget in the sidebar.

 

 

Sidebar Widgets are a main feature of any Magazine Blogging site. To aid with that Dispatch uses a nifty little plugin and a couple of custom CSS classes to make styling your sidebar a breeze.

Widget CSS Classes

Using the namesake plugin you can now add CSS Classes to Widgets. Simple.

Dispatch Widget Classes

CSS Class: zero-padding
Removes the padding from the widget. Perfect for adding those banner ads for maximum space.

CSS Class: no-background
Removes the widget color background that is set in the Customizer.

CSS Class: wpsp-card
Used exclusively with the WP Show Posts Widget and with zero-padding and no-background.
Read more here

Adding your own classes

Want different color background for your widgets. Heres how to. Add you Custom Class Name to your widget. In this example we’ll go for a red color and name our class red-background. Now thats added lets add some CSS.

.widget.red-background {
    background-color: #ff0000;
}