=== PublishPress Blocks - Block Controls, Block Visibility, Block Permissions ===
Contributors: publishpress, stevejburge, htmgarcia, olatechpro
Tags: gutenberg, gutenberg blocks, block editor, block visibility, block permissions
Requires at least: 5.5
Tested up to: 7.0
Stable tag: 3.7.2
Requires PHP: 7.2.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

PublishPress Blocks is your complete solution for the WordPress block editor. You can control block permissions, styles, visibility, usage and more.

== Description ==

[PublishPress Blocks](https://publishpress.com/blocks/) has everything you need to build professional websites with the WordPress block editor. This plugin has complete set of management tools for blocks. You can control which users can add which blocks to posts. You can manage block visibility, including user roles, date, time, device, screen size, and day of the week. Plus you can set default CSS styles, find all your blocks, manage your reusable blocks, and much more.

## Powerful block editor features in PublishPress Blocks

- **Block Permissions**: You can control who can use each block, including default WordPress blocks.
- **Extra Blocks**: There are over 20 extra blocks including accordions, tabs, and sliders.
- **PublishPress Blocks**: The blocks include accordions, galleries, sliders, tabs, maps, tables, recent posts, and more.
- **Block Styles**: You can add your own CSS styles for your blocks. Anyone editing posts can quickly add the styles to blocks.
- **Block Controls**: You can control block visibility, including user role, date, time, device, day of the week, and more.
- **Block Usage**: You can scan the posts on your website to find where your blocks are used.
- **Reusable Blocks**: You get easy access to manage and edit all the reusable blocks on your site.
- **Auto-Insert Blocks**: Automatically insert blocks into any location in your posts.

## PublishPress Blocks Pro

> <strong>Upgrade to Blocks Pro</strong><br />
> This plugin is the free version of PublishPress Blocks. The Pro version comes with faster support and all the features you need to super-charge the WordPress block editor. <a href="https://publishpress.com/blocks"  title="Blocks Pro">Click here to purchase the best premium WordPress blocks plugin now!</a>

## Block Permissions: Control Who Use Each Block

PublishPress Blocks allows you to enable or disable Gutenberg blocks for user roles. For example, you can disable the “Classic” block if you don’t want users to rely on the old WordPress editor. Using the PublishPress Blocks plugin, you can allow some user roles to use the Gutenberg blocks that you choose. You can select which blocks in the Blocks list will be available to each role.

[Click here to see how to control who can use each block](https://publishpress.com/knowledge-base/editor-profiles/).

## Extra Blocks: Over 20 Extra Gutenberg Blocks

PublishPress Blocks has everything you need to build professional websites with WordPress. Here's an introduction to the blocks available with the PublishPress Blocks plugin:

- **[Accordion block](https://publishpress.com/knowledge-base/advanced-accordion-block/)**: You can create a PublishPress Accordion block when you need to display a lot of content in a small area. Your site visitors will be able to click on accordion bars that slide out to reveal content.
- **[Button block](https://publishpress.com/knowledge-base/advanced-button-block/)**: The PublishPress Button block is based on the default Button block in Gutenberg. This improved version of the button block has tons of extra features including advanced styling such as hover, margin, border, padding, shadows and more.
- **[Columns Manager block](https://publishpress.com/knowledge-base/columns-manager-block/)**: The PublishPress Columns block is based on the default Columns block in Gutenberg. This new version of the block has many extra features including extra layout options, padding, margins and much more.
- **[Contact Form block](https://publishpress.com/knowledge-base/contact-form-block/)**: The Contact Form Block allows you to create a form and take messages from customers. You can customize every aspect of the form including the fields, text, colors, styling and spam protection. You can also view and export all entries from your forms.
- **[Content Display block](https://publishpress.com/knowledge-base/recent-posts-block/)**: PublishPress Blocks has a block to display your latest posts. Several views are available including Grid, List, Slider, Frontpage, Newspaper and Masonry. Some views have its own layouts and settings
- **[Count Up block](https://publishpress.com/knowledge-base/count-up-block/)**: The PublishPress Count Up block is perfect for showcasing a number in Gutenberg. You can use it to show how many clients you have, how much money you have raised, how many cups of coffee you've served, or anything else.
- **[Google Maps block](https://publishpress.com/knowledge-base/map-block/)**: The PublishPress Map block allows you to display a Google Map in the Gutenberg editor. You can create maps with custom icons, tooltips, description, zoom levels and much more.
- **[Icon block](https://publishpress.com/knowledge-base/advanced-icon-block/)**: The PublishPress Icon block allows you to add icons to WordPress content. This block uses Google's Material Design icons. You can customize the style, size, color, link, margin, padding, background, border and more.
- **[Image block](https://publishpress.com/knowledge-base/advanced-image-block/)**: The PublishPress Image block is based on the default Image block in Gutenberg. This improved version of the block has tons of extra features including focal points, overlays, custom text and more.
- **[Images Slider block](https://publishpress.com/knowledge-base/images-slider-block/)**: If you want to show multiple images in a slider / slideshow, then the PublishPress Images Slider Block is a great option. This Gutenberg block has advanced features including overlays, auto height, text, color and alignment options.
- **[Info Box block](https://publishpress.com/knowledge-base/info-box-block/)**: The PublishPress Info Box Block is a great way to show important information in the Gutenberg editor. You can have large, colorful icon displayed next to a large title and some text. This block allows you to use Google's Material Design icons.
- **[List block](https://publishpress.com/knowledge-base/advanced-list-block/)**: The PublishPress List block is based on the default List block in Gutenberg. This improved version of the block has tons of extra features including advanced styling such as custom icons, text size, margin, padding and more.
- **[Login / Register Form block](https://publishpress.com/knowledge-base/login-register-form-block/)**: The PublishPress Login & Register block allows you to load a WordPress login or register form inside Gutenberg. You can also setup a redirect URL after login and customize the design by adding your own logo and colors.
- **[Newsletter block](https://publishpress.com/knowledge-base/newsletter-block/)**: The PublishPress Newsletter block can save your future customers email for your marketing operations. You can create a sign-up block that's customized with your own styling and text.
- **[Search bar block](https://publishpress.com/knowledge-base/search-bar-block/)**: The PublishPress Search Bar block allows you to add a very customizable search form into Gutenberg. You can change the colors, icons, width and text of your search bar.
- **[Social Links block](https://publishpress.com/knowledge-base/social-links-block/)**: You can share your social media profiles very easily by using the PublishPress Social Links block. This block allows you to add links to your company / organization / personal profile on all the major social networks.
- **[Table of Contents block](https://publishpress.com/knowledge-base/summary-block/)**: The PublishPress Table of Contents block allows you to show a Table of Contents for your posts created with Gutenberg. WordPress automatically creates this Table of Contents using the headings in your post. This block enables you to place that Table of Contents so your visitors can see it.
- **[Table block](https://publishpress.com/knowledge-base/advanced-table-block/)**: The PublishPress Table block is based on the default Table block in Gutenberg. This improved version of the block has tons of extra table features including advanced styling such as margin, padding, alignment, colors and more.
- **[Tabs block](https://publishpress.com/knowledge-base/advanced-tabs-block/)**: You can create a PublishPress Tabs block when you need to display a lot of content in a small area. The tabs are mobile-friendly, can be horizontal or vertical, and can be customized with your colors and design.
- **[Testimonial block](https://publishpress.com/knowledge-base/testimonial-block/)**: The PublishPress Testimonial block allows you to add clients testimonials to Gutenberg. You can add testimonials using columns or a slider. You can show the avatar, name, job position and description for each testimonial.
- **[Video block](https://publishpress.com/knowledge-base/advanced-video-block/)**: The PublishPress Video block is based on the default Video block in Gutenberg. The PublishPress Video block is most useful for videos hosted on your WordPress site. This block has tons of extra features, including advanced styling, for locally-hosted videos.
- **[WooCommerce block](https://publishpress.com/knowledge-base/woo-products-block/)**: PublishPress Blocks comes with a block to display your WooCommerce products. There are 2 layouts available for the Woo Products block: the Grid and Slider views.

And there are also special blocks and features available in PublishPress Blocks Pro:

- **[Countdown block](https://publishpress.com/knowledge-base/countdown-block/)**: With the PublishPress Countdown blocks, you can create a highly customizable countdown to an event. This block is available in PublishPress Blocks Pro.
- **[Feature List block](https://publishpress.com/knowledge-base/feature-list-block/)**: With the Pro version of the PublishPress Blocks plugin, you can create an Features List block when you need to show a list of all the items available with a product or service.
- **[Pricing Table block](https://publishpress.com/knowledge-base/pricing-table-block/)**: With the Pro version of the PublishPress Blocks plugin, you can create a Pricing Table block when you need to show people the purchase or subscription options on your site.
- **[Google Fonts with core blocks](hhttps://publishpress.com/knowledge-base/core-blocks/)**: The Pro version of the PublishPress Blocks allow you to add use Google fonts with some core Gutenberg blocks such as paragraph and heading.

PublishPress Blocks features **the best content block in WordPress**. You can use the "Content Display" block to create blog layouts, lists of posts by a specific author, or even complete newspaper frontpages.

This block allows you to show posts, pages and other content types in many beautiful layouts. These layout options are *Grid*, *Frontpage*, *List*, *Newspaper*, *Masonry*, and *Slider*.

You also have dozens of different ways to customize your content. You can filter your content by author, category or tag. You can add many types of data to your layouts including posted date, updated date, images, authors, excerpts, intro text, comments and more.

We've already mentioned many features of the Content Display block. So what are you waiting for? **Install PublishPress Blocks and check out the Content Display block**. This block really is the best way to showcase your posts in the Gutenberg editor.

## Block Styles: Custom Design for Your Blocks

You can create custom styles for blocks and make them available to end users. Name the style, and let the content editors use it when they need it. There's an easy-to-use tool for creating styles, or you can bring your own CSS.

[Click here to see how to create block styles](https://publishpress.com/knowledge-base/custom-css/).

## Block Controls: Control Block Visibility on Your Site's Frontend

With Block Controls, you can schedule when blocks are shown, and also add user role restrictions. You can show blocks based on device type, browser, operating system, cookies, user data, and much more.

[Click here to read how to use block controls](https://publishpress.com/knowledge-base/how-to-use-block-controls/).

There are over a dozen different kinds of block visibility control available:

- **[Schedule](https://publishpress.com/knowledge-base/schedule-control/)**: schedule when to start showing and/or stop showing a block.
- **[User roles](https://publishpress.com/knowledge-base/user-roles-control/)**: choose which users can see your blocks.
- **[Device Width](https://publishpress.com/knowledge-base/device-type-control/)**: show and hide blocks on specific device sizes.
- **[Device Type](https://publishpress.com/knowledge-base/device-type/)**: Select what type of device this block will be visible on.
- **[Browser](https://publishpress.com/knowledge-base/browser-control/)**: Choose which browsers can see this block.
- **[Operating System](https://publishpress.com/knowledge-base/operating-system-control/)**: Choose which operating systems can see this block.
- **[Cookie](https://publishpress.com/knowledge-base/cookie-control/)**: Show or hide the block based on cookie values.
- **[User Meta](https://publishpress.com/knowledge-base/user-meta-control/)**: Show or hide block based on user meta values.
- **[Post Meta](https://publishpress.com/knowledge-base/post-meta-control/)**: Show or hide block based on post meta values.
- **[Query String](https://publishpress.com/knowledge-base/query-string-control/)**: Show or hide block based on URL query parameters.
- **[Capabilities](https://publishpress.com/knowledge-base/capabilities-control/)**: Show or hide block based on user capabilities.
- **[Term Archives](https://publishpress.com/knowledge-base/term-archives-control/)**: Choose on which taxonomies and terms archive pages your blocks can be displayed.
- **[Pages](https://publishpress.com/knowledge-base/pages-control/)**: Choose in which pages this block can be displayed.


## Block Usage: Find Your Blocks

The Block Usage feature allows you to search for and find any usage of blocks on your site. Find your blocks quickly. Using this screen, you can scan all the content on your site and find where each block is located.

[Click here for more on the Block Usage Screen](https://publishpress.com/knowledge-base/block-usage/).

## Reusable Blocks: Build a Block Once and Use it Everywhere

When you are using PublishPress Blocks, a submenu for Reusable Blocks is enabled by default. This submenu allows you to reach the “Reusable blocks” page screen that is normally difficult to find in WordPress. Reusable blocks are an incredibly useful feature in the Gutenberg block editor. They allow you to create content once and use it multiple times inside different posts and pages.

[Click here for more on the Reusable Blocks Screen](https://publishpress.com/knowledge-base/how-to-enable-disable-reusable-blocks-submenu/).

## Reusable Blocks: Build a Block Once and Use it Everywhere

When you are using PublishPress Blocks, a submenu for Reusable Blocks is enabled by default. This submenu allows you to reach the “Reusable blocks” page screen that is normally difficult to find in WordPress. Reusable blocks are an incredibly useful feature in the Gutenberg block editor. They allow you to create content once and use it multiple times inside different posts and pages.

[Click here for more on the Reusable Blocks Screen](https://publishpress.com/knowledge-base/how-to-enable-disable-reusable-blocks-submenu/).

## Auto-Insert Blocks

The Auto-Insert Blocks feature allows you to automatically insert reusable blocks into posts. You can choose to insert your blocks according position, categories, tags, and other criteria. This ideal for adding promotional banners, newsletter sign-ups, or anything that needs to be shown multiple times in your posts.

[Click here for more on Auto-Insert Blocks](https://publishpress.com/knowledge-base/auto-insert-blocks/).

## Join PublishPress and get the Pro plugins

The Pro versions of the PublishPress plugins are well worth your investment. The Pro versions have extra features and faster support. [Click here to join PublishPress](https://publishpress.com/pricing/).

Join PublishPress and you'll get access to these Pro plugins:

* [PublishPress Authors Pro](https://publishpress.com/authors) allows you to add multiple authors and guest authors to WordPress posts.
* [PublishPress Blocks Pro](https://publishpress.com/blocks) has everything you need to build professional websites with the WordPress block editor.
* [PublishPress Capabilities Pro](https://publishpress.com/capabilities) is the plugin to manage your WordPress user roles, permissions, and capabilities.
* [PublishPress Checklists Pro](https://publishpress.com/checklists) enables you to define tasks that must be completed before content is published.
* [PublishPress Future Pro](https://publishpress.com/future) allows you to schedule changes to WordPress Posts.
* [PublishPress Permissions Pro](https://publishpress.com/permissions) is the plugin for advanced WordPress permissions.
* [PublishPress Planner Pro](https://publishpress.com/publishpress) is the plugin for managing and scheduling WordPress content.
* [PublishPress Revisions Pro](https://publishpress.com/revisions) allows you to update your published pages with teamwork and precision.
* [PublishPress Series Pro](https://publishpress.com/series) enables you to group content together into a series.
* [PublishPress Shortlinks Pro](https://publishpress.com/shortlinks) allows you to create custom URLs for your posts and external links.
* [PublishPress Statuses Pro](https://publishpress.com/statuses) enables you to create additional publishing steps for your posts.

Together, these plugins are a suite of powerful publishing tools for WordPress. If you need to create a professional workflow in WordPress, with moderation, revisions, permissions and more... then you should try PublishPress.

## Bug Reports ##

Bug reports for PublishPress Blocks are welcome in our [repository on GitHub](https://github.com/publishpress/publishpress-blocks). Please note that GitHub is not a support forum, and that issues that aren't properly qualified as bugs will be closed.

## Follow the PublishPress team ##

Follow PublishPress on [Facebook](https://www.facebook.com/publishpress), [Twitter](https://www.twitter.com/publishpresscom) and [YouTube](https://www.youtube.com/publishpress).

== Installation ==

= To install the plugin automatically: =
* Through WordPress admin, use the menu: Plugin > Add New
* Search for PublishPress Blocks
* Click on install then click the activation link

== Frequently Asked Questions ==

= Can I get support for PublishPress Blocks? =

We reply to every question about the editor on the forum here, just ask :) We also have [online documentation here](https://publishpress.com/knowledge-base/installation/).

= How do I add accordion blocks in Gutenberg? =

You can create a PublishPress Accordion block by clicking the "Accordion - PublishPress" button in the PublishPress Blocks category. When you first create this block, you will see 2 accordion elements that display by default. Once created, you can adjust the header, body or border options for your accordion. The Accordion block also allows you to customize the borders of the accordion areas:

[Click here for more on Gutenberg accordion blocks](https://publishpress.com/knowledge-base/advanced-accordion-block/).

= How do I add button blocks in Gutenberg? =

The PublishPress Button block is based on the default Button block in Gutenberg. This improved version of the button block has tons of extra features including advanced styling such as hover, margin, border, padding, shadows and more. You can create a PublishPress Button block by clicking the "Accordion - PublishPress" button in the PublishPress Blocks section. There are options for customizing the test size, background color and text color for the button. There are also customization options for the color, borders, margin, and padding of your buttons. You can choose settings that control what visitors see when they hover over your button blocks.

[Click here for more on Gutenberg button blocks](https://publishpress.com/knowledge-base/advanced-button-block/).

= How do I add icon blocks in Gutenberg? =

The PublishPress Icon block allows you to add icons to WordPress content. This block uses Google's Material Design icons. You can customize the style, size, color, link, margin, padding, background, border and more. You can create a PublishPress Icon block by clicking the "Icon - PublishPress" button in the PublishPress Blocks section. After you choose an icon, you will see extra settings in the right sidebar, including Icon Size, Icon Color, Icon Background, Border, Border Size, Border Radius.

[Click here for more on Gutenberg icon blocks](https://publishpress.com/knowledge-base/advanced-icon-block/).

= How do I add list blocks in Gutenberg? =

The PublishPress List block is based on the default List block in Gutenberg. This improved version of the block has tons of extra features including advanced styling such as custom icons, text size, margin, padding and more. You can create a PublishPress List block by clicking the "List - PublishPress" button in the PublishPress Blocks section. After creating the PublishPress List block, you can adjust the settings from the right sidebar. You can change the icon and it's settings which include List icon, Icon size, Line height, Margin, Padding, and more.

[Click here for more on Gutenberg list blocks](https://publishpress.com/knowledge-base/advanced-list-block/).

= How do I add table blocks in Gutenberg? =

The PublishPress Table block is based on the default Table block in Gutenberg. This improved version of the block has tons of extra table features including advanced styling such as margin, padding, alignment, colors and more. You can create a PublishPress Table block by clicking the "Table - PublishPress" button in the PublishPress Blocks section. After choosing the PublishPress Table block, you can choose the number of columns and rows for your table layout. You can edit the table after setting the number of columns and rows. The options include:<br />

* Add Row Before
* Add Row After
* Delete Row
* Add Column Before
* Add Column After
* Delete Column
* Split Merged Cells
* Merge Cells

[Click here for more on Gutenberg table blocks](https://publishpress.com/knowledge-base/advanced-table-block/).

= How do I add tabs blocks in Gutenberg? =

You can create a PublishPress Tabs block when you need to display a lot of content in a small area. The tabs are mobile-friendly, can be horizontal or vertical, and can be customized with your colors and design. To insert a PublishPress Tabs block, click the "Tabs - PublishPress" button in the PublishPress Blocks category. You can add tabs using the large + icon. You can remove tabs using the yellow X icon. The block settings allow you to adjust the tab direction and also which tab people will see when they open the page.

[Click here for more on Gutenberg tabs blocks](https://publishpress.com/knowledge-base/advanced-tabs-block/).

= How do I add columns blocks in Gutenberg? =

The PublishPress Columns block is based on the default Columns block in Gutenberg. This new version of the block has many extra features including extra layout options, padding, margins and much more. If you want to create a block containing other blocks inside, you should choose "Columns - PublishPress" in PublishPress Blocks category. Then you can add any types of block you want in each column. You can choose different layouts for Desktop, Tablet, and Mobile displays. You can also choose the space between columns, padding, margin, and much more.

[Click here for more on Gutenberg columns blocks](https://publishpress.com/knowledge-base/columns-manager-block/).

= Does PublishPress Blocks slow down my website? =

No. The impact is minimal because our plugin relies heavily on tools provided by the native Gutenberg editor.

Many of our blocks are built on top of the default Gutenberg blocks, so little extra code is necessary. And if you decide to stop using PublishPress Blocks, any Gutenberg block will safely turn back to regular HTML. This means that PublishPress Blocks is a safe option to use, because your content is not locked into our plugin forever.

[Read more about disabling PublishPress Blocks](https://publishpress.com/knowledge-base/disable-advanced-gutenberg/).

= Can I add a lightbox display to the WordPress gallery block? =

Yes, with the PublishPress Blocks plugin, you can show WordPress images inside a lightbox modal. This feature is not available in the normal WordPress gallery block. This feature is on the Configuration screen in PublishPress Blocks. This will modify the default “Gallery” block in WordPress.

* Open galleries in lightbox: This will automatically add a lightbox display to images in the “Gallery” block.
* Image caption: This feature will automatically take the alt text or caption for an image and show it as captions for images in lightboxes. You can choose between display the caption below the image or over.

= Can I add anchor links to WordPress blocks? =

Yes, it is possible to create anchor links for Gutenberg blocks. This allows you to create direct links to blocks, rather than to the top of a page. They allow visitors to click a link and instant moved up or down a long page.

* When editing a block, look for the “Advanced” tab in the right sidebar.
* Under the “Advanced” tab, look for the “HTML anchor” box.
* Enter the name of your anchor.

This feature is available for all PublishPress blocks, except for these:

* Icons
* Columns
* Info Box
* Content Display
* Testimonial

= What happens to my content if I disable PublishPress Blocks?

If you disable the PublishPress Blocks plugin, the blocks will revert to HTML. This means that PublishPress Blocks is a safe option to use, because your content is not locked into our plugin forever. Our plugin will not negatively impact your use of the block editor.

[Click here for more information on disabling blocks](https://publishpress.com/knowledge-base/disable-advanced-gutenberg/)

= How does PublishPress Blocks compare to CoBlocks, Kadence Blocks, Getwid, Ultimate Blocks? =

All of these are good Gutenberg block plugins. PublishPress Blocks has particular strengths with the 5 features we mention in the introduction:

* The best Latest News / Content block in WordPress
* Over 20 extra Gutenberg blocks
* Permissions for the block editor
* Block styles to add reusable custom CSS to any block
* Block layout and page-builder features

= Can I share a link to install PublishPress Blocks? =

Yes, we use the phrase "publishpress-advg-install" to share install links. You will see that text included in the links from other PublishPress plugins.

== Screenshots ==

1. Content Display Block: PublishPress Blocks include Content Display, a powerful block to show posts, pages and custom post types in many beautiful layouts.
2. Block permissions: PublishPress Blocks allows you to enable or disable blocks per user role.
3. Column Layouts: PublishPress Blocks allows you to create flexible and beautiful layouts. You get 23 layouts options with different options for desktop, tablet and mobile devices.
4. WooCommerce Products: PublishPress Blocks comes with a block to display your latest WooCommerce products.
5. Countdown Block: Create a customizable countdown block with a lot of settings, including date and time layout, font size, and more.
6. Content Blocks: PublishPress Blocks has multiple blocks to improve your content. You can create a Table of Contents block, build stylish lists with icons, and add attractive buttons with many design options.
7. Image and Video Blocks: With the PublishPress Video block, you can display remote or local videos with a customizable player and tons of options. The PublishPress Image block: get more controls over your images with zoom, opacity, captions and much more.
8. Email and Contact Form Blocks: You can create Contact form and also Newsletter sign-up blocks.
9. Gutenberg Accordion Block: You can display content in an accordion layout. The content of each accordion can be visually edited.
10. Gutenberg Info Box and Icon Blocks: The Info Box blocks allows you to show information with an icon, title and text with custom styles.
11. Google Maps: With the Map block you can display a Google Map with a custom icon, tooltip and description.
12. Count up blocks: The Count Up block is perfect for showcasing numbers in Gutenberg. You can use it to show how many clients you have, how much money you have raised etc.
13. Testimonial Blocks: The Testimonial Block allows you to add clients testimonials to Gutenberg.
14. Login & Register Gutenberg Block: This block allows you to load a WordPress login or registration form inside Gutenberg.
15. Gallery Enhancements: PublishPress Blocks has major improvements for the default WordPress galleries, including lightbox displays, image captions, and better image navigation.
16. Block Styles: You create custom CSS styles for blocks and make them available to end users.

== Changelog ==

The full changelog can be found on [GitHub](https://github.com/publishpress/publishPress-blocks/blob/master/CHANGELOG.md).
