=== El mejor Cluster ===
Contributors: derethor
Tags: seo,related posts
Requires at least: 4.7
Tested up to: 6.6.2
Stable tag: 1.1.16
Requires PHP: 8.0
License: GPL-2.0+
License URI: http://www.gnu.org/licenses/gpl-2.0.txt

Create easy related posts blocks with a simple shortcode.
This plugin is light, very easy to use and designed for SEO.

== Description ==
This plugin with create a related post block with a simple shortcode.

You can configure the title, description and image of each post (by default will use the title, first  content words and featued image of the post)

You can setup few global options to change the visual aspect of the block.

Visit the official wordpress plugin page: https://wordpress.org/plugins/mejorcluster/

== Change Log ==

1.1.16:

- Using a while list for title_tag to prevent XSS attacks. This can break compatibility if you are using this field for custom html code.

  [mejorcluster title_tag='h4']

  white list of allowed title tags:

  h1 h2 h3 h4 h5 h6 p span b i u strong em ul ol li a blockquote code div section article aside nav header footer td

1.1.15:

- Fix 1.1.14 vulnerable to Cross Site Scripting (XSS) https://patchstack.com/database/report-preview/5cf34627-9138-47e5-a25d-09b24efa12ee?pin=2Y6KTWHtG1i5ZyxA

1.1.14:
- Fix typoos

1.1.13:
- Fix bug that caused the plugin to crash with PHP 8

1.1.12:

- Added functionality to be able to search posts by category name. Example: [mejorcluster category_name="Category1"]
- Added functionality to be able to search posts by slug. Example: [mejorcluster posts_names="el-mejor-cluster,another-post"]
- fix bug with default post type and post parents

1.1.11:

- fixed quotes with rel=bookmark
- check that meta has a valid key=value format

1.1.10:

- added the category="id" to find posts that have one category (and any children of that category). For example category="4".

1.1.9:

- added the meta="key=value" to find posts with a custom field

1.1.8:

- added the title_maxwords and desc_maxwords parameters (also global) to limit the number of words displayed
- now you can hide the meta box on post editor (go to settings and select 'hide custom box')

== How to use ==

### Default usage

    [mejorcluster]

### Basic usage

    [mejorcluster posts="20,2,9,51,55,59,63,67,71"]
    [mejorcluster parent="2,3,4"]
    [mejorcluster categories="3,4"]
    [mejorcluster categories="3" exclude="101"]
    [mejorcluster tags="4,5"]

### Sister pages (with same parent)

    [mejorcluster parent="post_parent"]
    [mejorcluster parent="post_parent" exclude="self"]

### Rounded and shadows style

    [mejorcluster posts="20,2,9,51,55,59,63,67,71" round="yes" shadow="yes" skip_title="no"]

### Skip Links

    [mejorcluster posts="20,2,9,51,55,59,63,67,71" skip_title_link="yes"]
    [mejorcluster posts="20,2,9,51,55,59,63,67,71" skip_image_link="yes"]

### Title and Desc HTML Tag

    [mejorcluster posts="20,2,9,51,55,59,63,67,71" title_tag="h3"]
    [mejorcluster posts="20,2,9,51,55,59,63,67,71" desc_tag="h5"]

### Title and Desc max len

    [mejorcluster posts="20,2,9,51,55,59,63,67,71" title_maxwords="2"]
    [mejorcluster posts="20,2,9,51,55,59,63,67,71" desc_maxwords="50"]

### Image Size

    Use the same name than the wordpress size name (i.e. medium, large, etc)

    [mejorcluster imagesize="large"]

### Grid

    [mejorcluster posts="20,2,9,51,55,59,63,67,71" grid="3" maxitems="9"]
    [mejorcluster posts="20,2,9,51" grid="1" classname="clusterlist" maxitems="9" skip_image="yes" shadow="no" skip_title_link="no" skip_desc="yes"]

### Spanish video tutorial

[https://media.publit.io/file/mejorcluster-optimized.mp4](https://media.publit.io/file/mejorcluster-optimized.mp4)

== Frequently Asked Questions ==

### Is this plugin abandoned?

Not really. While the plugin is quite simple and doesn't require much maintenance, I still use it on my websites and update it as needed to fix any issues.