Recommended releases

Download Links

Void Menu creates valid link item placeholders for use in the Backdrop menu system. This module allows you to use items in your links that would previously be rejected by Backdrop.

You may have seen this technique in the "single page" websites that are often step based marketing pages for an event, company services or a new product.

You can assign up to ten void items any HTML value that you desire and have it instantly available as a menu item. Including JavaScript function calls.

Void Menu allows you to set custom href attributes for your menu items, which unlocks the potential to (among other things) invoke JavaScript functions from your menus.

An example

Let's say you have created a custom JavaScript function that will set or check a cookie for a user and then send them to a specified location or apply a new condition to the page based on that operation. Prior to void menu we needed to add long winded alter functions in order to accomplish this. Now we simply assign javascript: MyCustomFunction(); to one of our void tags, and we can freely use that in any Backdrop menu.

There's more

As an added bonus, and because of the functionality of this module, you are also able to use actual anchors as menu items that serve no other purpose than placeholders. This is accomplished with a void tag that is set to javascript: void(0); or even a simple hash tag #. The benefit to using this module over special_menu_items for this is that your menus will not require any additional styling to account for the added span tags used by special_menu_items, and will be W3C valid because every anchor must have an href attribute.

CONTENTS OF THIS FILE

  • Introduction
  • Tested
  • Known Issues
  • Special Thanks
  • Requirements
  • Installation
  • Coming From Drupal?
  • Usage
  • License
  • Credits
  • Maintainers

TESTED

This module has been manually tested successfully creating several working menu items in Backdrop.

KNOWN ISSUES

Security

This module allows users to enter Javascript and hook it into the Drupal menu system. Any user with "Administer Site Configuration" will have access to this module, and many others that could prove harmful if a malicious user was given free reign over your web site. Always verify which users you are granting access to Administer your site.

SPECIAL THANKS

Written by William Hall - www.mrtheme.com
Based off of the work done in special_menu_items and menu_firstchild

You may also email me directly at will@mrtheme.com

REQUIREMENTS

A "parallax scrolling" looking website often has to use these four modules together:

  • parallax_bg
  • scrollreveal
  • void_menu
  • back_to_top

INSTALLATION

Install this module using the official Backdrop CMS instructions at https://backdropcms.org/guide/modules

Configure the module settings at Administer -> Configuration -> User Interface -> Void Menu (admin/config/user-interface/void_menu).

COMING FROM DRUPAL?

Nothing substantially different.

PERMISSIONS

@todo

USAGE

LICENSE

This project is GPL v2 software. See the LICENSE.txt file in this directory for complete text.

CREDITS

This module is based on the Project module for Drupal, originally written and maintained by a large number of contributors, including:

MAINTAINERS

  • seeking

Ported to Backdrop by: