Skip to content

DanielFloeter/hyperlink-group-block

Repository files navigation

=== Hyperlink Group Block ===
Contributors:      kometschuh
Donate link:       https://wordpress.org/support/plugin/hyperlink-group-block/reviews/?filter=5
Tags:              block, hyperlink, link, gutenberg, anchor
Requires at least: 5.6
Tested up to:      6.7
Stable tag:        2.0.0
Requires PHP:      7.0.0
License:           GPL-2.0-or-later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Combine blocks into a group wrapped with an hyperlink (<a>).

== Description ==

Combine blocks into a group wrapped with an hyperlink (<a>).
After inserting a Hyperlink Group Block, a Block inserter icon will be displayed to allow you to add new Blocks inside that Hyperlink Group Block.

= Tip Top Press =
We're [Tip Top Press](http://tiptoppress.com/?utm_source=wp.org&utm_medium=readme.txt&utm_campaign=hyperlink+group+block&utm_content=TipTopPress) and create Gutenberg Blocks for Wordpress. If you want to know about what we're working on and you are interested in backgrounds then you can read all newes storys on our [blog](http://tiptoppress.com/blog/?utm_source=wp.org&utm_medium=readme.txt&utm_campaign=hyperlink+group+block&utm_content=blog).

= Grouping Existing Blocks =
It's also possible to group existing Blocks. 
Select the Blocks which should be grouped with a Hyperlink. The Block Toolbar will appear. Click on the Block icon and select the Hyperlink Block to transform the selected Blocks to an Hyperlink Block with some InnerBlocks.

= Advanced =
On the Advanced Tab set the link's [rel](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel), [title](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/title) and [aria-label](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-label) attributes.

= Features =
* Wrap Blocks with a hyperlink
* Use link from Query Loop Block
* Transform Blocks into a group wrapped with an HTML anchor tag (<a>)
* Set the link href attribute
* Set rel, title and aria-label attributes
* Option open in a new window
* Set hover background color
* Inner anchor elements are automatically deleted

= Contribute =
While using this plugin if you find any bug or any conflict, please submit an issue at [Github](https://github.com/DanielFloeter/hyperlink-group-block) (If possible with a pull request).

== Installation ==

This section describes how to install the plugin and get it working.

e.g.

1. Upload the plugin files to the `/wp-content/plugins/hyperlink-group-block` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress 


== Frequently Asked Questions ==

= WPML support (translate the anchor) =

There are two kinds for WPML translation.

Translate with "WordPress Editor", not with "WPML Translation Editor":
WPML > Settings > Translation Editor > Classic Translation Editor
or
Your site in admin / gutenberg mode > right sidebar / Page > language > Translations > WordPress Editor

Other option but there is a bug, it doesn't work for us?
[wpml.org/faq](https://wpml.org/faq/) / FAQ > How-To > "How can I translate links and HTML attributes in the Advanced Translation Editor?"
Search content: "http" [YouTube](https://wpml.org/announcements/2020/02/translating-links-with-advanced-translation-editor/)

= Can I use links within the Hyperlink Group Block? =

No, that is illegal and causes errors in the renderd HTML.

== Screenshots ==

1. Hyperlink Group Block to group Blocks with an hyperlink.
2. Wrap Blocks with a link.
3. Rendered HTML.
4. Advanced Settings for rel attributes.
5. Transform Blocks into a group wrapped with an anchor tag

== Changelog ==

= 2.0.0 - Nov 05th 2024 =
* Title attribute

= 1.17.6 - Oct 24th 2024 =
* Bugfix Nested anchors
* Escape output

= 1.17.5 - April 5th 2024 =
* Bugfix Extra quotes

= 1.17.4 - April 3rd 2024 =
* Bugfix Don't render unless HTML

= 1.17.3 - April 2nd 2024 =
* Bugfix Delete deprecated

= 1.17.2 - April 1st 2024 =
* Aria-label

= 1.17.1 - April 25th 2023 =
* Bugfix No content

= 1.1.6 - April 23th 2023 =
* Bugfix Deprecated

= 1.1.5 - April 19th 2023 =
* Bugfix Styles don't work

= 1.1.4 - April 12th 2023 =
* Bugfix Selector priority

= 1.1.3 - April 12th 2023 =
* Bugfix No CSS class

= 1.1.2 - April 10th 2023 =
* Bugfix Delete test code

= 1.1.1 - April 06th 2023 =
* Option Background Color onhover

= 1.0.9 - March 24th 2023 =
* Use link from Query Loop Block

= 1.0.8 - August 20th 2022 =
* Render CSS classes

= 1.0.7 - August 20th 2022 =
* No saving when adding CSS classes

= 1.0.6 - March 07th 2022 =
* Markup migration code

= 1.0.5 - March 06th 2022 =
* Backward compatible experimental flag usage

= 1.0.4 - February 13th 2022 =
* Delete inner anchor elements

= 1.0.3 - February 04th 2022 =
* Bugfix Disable focus if link picker is open
* Bugfix Set color

= 1.0.2 - February 04th 2022 =
* Bugfix __experimental code deleted in Gutenberg 12.5

= 1.0.1 - July 07th 2021 =
* Transforms

= 0.9.1 - July 06th 2021 =
* Release

About

Combine blocks into a group wrapped with an hyperlink

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •