Posts Block

Description

Posts Block adds a responsive Posts block to the block editor inserter that can be added to display posts in a list, grid or carousel.

Features

  • Responsive
  • Settings
    • Block alignment
    • Layout
      • List
      • Grid
      • Carousel
    • Text alignment
    • Post type [Pro]
    • Number of posts
    • Order by
    • Order
    • Number of columns
    • Column gutter width
    • Display featured image
    • Display title
    • Add heading to title
    • Title heading
    • Display author
    • Display date
    • Display excerpt
    • Maximum number of words in excerpt
    • Display content
    • Display link
    • Link text
    • Carousel
      • Display dots
      • Display arrows
      • Infinite
      • Speed
      • Slides to show
      • Slides to scroll
  • Styles
    • Color
      • Text
      • Background
      • Link
      • Carousel dots [Pro]
      • Carousel dots hover [Pro]
      • Carousel arrows [Pro]
      • Carousel arrows hover [Pro]
    • Typography
      • Font family
      • Font size
      • Appearance
      • Line height
      • Letter spacing
      • Text decoration
      • Letter case
    • Dimensions
      • Padding
      • Margin
      • List post padding [Pro]
      • List post margin [Pro]
      • Grid post padding [Pro]
      • Grid post margin [Pro]
      • Carousel post padding [Pro]
      • Carousel post margin [Pro]
      • Featured image padding [Pro]
      • Featured image margin [Pro]
      • Title padding [Pro]
      • Title margin [Pro]
      • Meta padding [Pro]
      • Meta margin [Pro]
      • Excerpt padding [Pro]
      • Excerpt margin [Pro]
      • Content padding [Pro]
      • Content margin [Pro]
      • Link padding [Pro]
      • Link margin [Pro]
  • Variations [Pro]
    • List [Pro]
    • Grid [Pro]
    • Carousel [Pro]

HTML

Posts Block will output a Posts block with the following HTML structure:

<ul class="wp-block-tt-posts wp-block-tt-posts-6">
    <li class="wp-block-tt-posts-post">
        <div class="wp-block-tt-posts-post-featured-image”>
            <img class=“wp-block-tt-posts-post-thumbnail” src=“#”>
        </div>
        <h3 class="wp-block-tt-posts-post-title">
            <a href=“#”>Title</a>
        </h3>
        <div class="wp-block-tt-posts-post-meta">
            <span class="wp-block-tt-posts-post-meta-date">Posted <time class="wp-block-tt-posts-post-meta-date-time" datetime="2023-11-01T12:00:00+00:00">November 1, 2023</time></span>
        </div>
        <div class="wp-block-tt-posts-post-excerpt">Excerpt</div>
        <a class="wp-block-tt-posts-post-link" href=“#”>Read more</a>
    </li>
</ul>

Support

If you need help with Posts Block, please submit a ticket on the Support forum.

If you like Posts Block and would like to support it’s future development, how about buying me a coffee?

Contribute

If you would like to contribute to the development of Posts Block, the repository is located on GitHub.

License

Posts Block is released under the GNU General Public License, version 2 (GPLv2).

Requirements

  • WordPress 6.0 or greater
  • PHP version 7.4 or greater
  • MySQL version 5.7 or greater or MariaDB version 10.3 or greater.

Installation

Posts Block can be installed in one of the following three ways:

Upload

To install with a .zip file:

  1. Login to your WordPress site at domain.com/wp-admin, where domain.com is the domain of your WordPress site.
  2. On the Dashboard page, in the left menu, click Plugins.
  3. On the Plugins page, click Add New Plugin.
  4. On the Add Plugins page, click Upload Plugin.
  5. Click Choose File, locate the .zip file and click Open.
  6. Click Install Now.
  7. On the Installing Plugin from uploaded file page, click Activate.

Manual

To install with a SFTP client:

  1. If you have a .zip file, unzip it with archiving software such as WinZip or Archive Utility.
  2. In a SFTP client such as WinSCP or FileZilla, connect to your WordPress site directory on your server.
  3. In the unzipped files, copy the posts-block folder and paste on your server, in your site’s wp-content/plugins folder.
  4. Login to your WordPress site at domain.com/wp-admin, where domain.com is the domain of your WordPress site.
  5. On the Dashboard page, in the left menu, click Plugins.
  6. On the Plugins page, locate Posts Block and click Activate.

Theme

To install in your theme instead of a plugin:

  1. If you have a .zip file, unzip it with archiving software such as WinZip or Archive Utility.
  2. In the unzipped files, copy the posts-block folder and paste in your site’s theme folder, such as wp-content/themes/your-theme/inc/posts-block/, where your-theme is your theme folder.
  3. In a code editor such as Visual Studio Code or Notepad++, open your theme’s functions.php file.
  4. In your functions.php file, add the path from Step 2, such as require get_stylesheet_directory() . ‘/inc/posts-block/posts-block.php’;.
  5. Save and close your functions.php file.

FAQ

What are posts?

Posts are dynamic and time-based content typically used for blogs, news, events, etc. Posts are usually listed in reverse chronological order, can be tagged, categorized and commented on.

How do I install Posts Block?

Please see Installation section.

How do I add a Posts block?

  1. Login to your WordPress site at domain.com/wp-admin, where domain.com is the domain of your WordPress site.
  2. On the Dashboard page, in the left menu, click Posts or Pages.
  3. On the Posts or Pages page, either click Add New, search for and/or click the desired post or page title.
  4. In the block editor, either:
    • Click the block inserter + icon in the top toolbar
    • Click the block inserter + icon to the right of an empty block, or
    • Click the block inserter + icon between blocks
  5. In the block inserter pop-up modal window, search for and/or click Posts to add a Posts block.

How do I edit a Posts block?

  1. Login to your WordPress site at domain.com/wp-admin, where domain.com is the domain of your WordPress site.
  2. On the Dashboard page, in the left menu, click Posts or Pages.
  3. On the Posts or Pages page, search for and/or click the desired post or page title.
  4. In the block editor, click the desired Posts block.
  5. In the block toolbar above, select the desired block alignment, layout, text formatting and/or other options.
  6. In the settings sidebar, in the Block tab:
    • In the Settings tab, select the desired settings.
    • In the Styles tab, select the desired ColorTypography and/or Dimensions settings.

How do I setup a development environment?

  1. Install WordPress on a local server such as LocalDockerMAMP or XAMPP.
  2. To install Posts Block on your local site, see Installation section.
  3. If node.js is not already installed locally, go to https://nodejs.org/ to install.
  4. In a Command Line Interface (CLI) such as Command Prompt or Terminal, navigate to the posts-block folder. For example, cd localhost/your-site/wp-content/plugins/posts-block.
  5. To install project dependencies, type npm install.
  6. In the posts-block folder, edit the desired file or files.
  7. To create or update the production build directory, type npm run build. For other commands, type npm run.

Screenshots

Posts block added from the block inserter.
Posts block variations [Pro].
Posts block with default settings.
Posts block with list view settings.
Posts block with grid view settings.
Posts block with carousel settings.
Posts block on the front end.

Changelog

0.1.0 – November 15, 2023

  • Initial release

Credits