---
title: 'Grav Admin Power Tools'
url: 'https://www.twelvetone.tv/docs/developer-tools/grav-plugins/grav-admin-power-tools'
markdown: 'https://www.twelvetone.tv/docs/developer-tools/grav-plugins/grav-admin-power-tools.md'
date: '2026-09-25'
description: 'Adds power-user features to the Grav Admin plugin. Many'
taxonomy:
  category:
    - docs
  devtype:
    - mit
---

[](#)  [ Home ](https://www.twelvetone.tv/docs/)     [ Developer Tools ](https://www.twelvetone.tv/docs/developer-tools)     [ Grav Plugins ](https://www.twelvetone.tv/docs/developer-tools/grav-plugins)      Grav Admin Power Tools    

# Grav Admin Power Tools

This product is in active development and has been released under the [MIT license](https://opensource.org/licenses/MIT).

Adds power-user features to the Grav Admin plugin.

Many features in this plugin are **experimental**. They may or may not work as intended in every circumstance. Please make sure to backup before trying any feature that may modify your files. Most features can be individually enabled/disabled from the plugin menu.

Download it [here](https://github.com/Flamenco/admin-power-tools).

#### Table of Contents

- [Edit Buttons](#edit-buttons)
    - [Edit This Page](#edit-this-page)
    - [Edit This Section](#edit-this-section)
    - [Move Section To Child Page](#move-section-to-child-pag)
- [Reorder Child Pages](#reorder-child-pages)
- [Move Page](#move-page)
- [Rename Page](#rename-page)
- [UI Improvments](#ui-improvments)
    - [Dashboard View Link](#dashboard-view-link)
    - [Navigate To Parent](#navigate-to-parent)
    - [Smooth Scrolling](#smooth-scrolling)
    - [Menu Scrolling](#menu-scrolling)
- [New +Add menu commands](#new-add-menu-commands)
- [Reports](#reports)
    - [Standard Reports](#standard-reports)
    - [Screenshots](#screenshots)
- [Developer Tools](#developer-tools)
    - [Twigs](#twigs)
        - [Admin](#admin)
        - [Site](#site)
    - [Dialog Utilities](#dialog-utilities)
    - [Form Widgets](#form-widgets)
        - [page-picker](#page-picker)
        - [order-child](#order-child)
        - [section](#section)
    - [Full Screen Utilities](#full-screen-utilities)
    - [Fast Filter](#fast-filter)
- [Plugin Options](#plugin-options)

# Edit Buttons

Adds *Edit This Page* and *Edit This Section* links to pages.

If the frontmatter contains the value `editable: false`the links will not be added.

This feature can be disabled on the plugin configuration page.

## Edit This Page

Adds an 'Edit Page On Grav' link to the bottom of all pages. ![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/02.grav-admin-power-tools/edit%20on%20grav.png)

## Edit This Section

Adds an 'Edit Section' link after every heading. In theory, different sections can be modified at the same time by different users.

A *section* is a heading and the content up to the next heading with the same level.

![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/02.grav-admin-power-tools/section.png)

If you use the *toc plugin*, edit section links will also be added to the *table of contents*.

![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/02.grav-admin-power-tools/toc%20edit%20links.png)

Use the *section editor* to change the heading and markdown for an individual section. You can also delete the entire section. ![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/02.grav-admin-power-tools/section%20editor.png)

If headings have the same level and text, only the first one will be editable.

A very naive method is used to parse your markdown; We have seen cases where sublevels are *duplicated* after using this feature, so beware.

## Move Section To Child Page

You can move an entire section to a new child page. This removes the section from the current page, and creates a new page using the edited section as the title. This creates a *refactoring* workflow for markdown documents.

# Reorder Child Pages

You can now view and reorder child pages in the page editor. The change happens immediately; The parent page does not need to be saved.

![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/02.grav-admin-power-tools/reorder-child-pages.png)

# Move Page

This action moves a selected page and renames any child references that use a name-only link.

todo: This feature has been removed until we migrate the name-only link feature from another plugin

# Rename Page

This action renames a selected page and renames any child references that use a name-only link.

todo: This feature has been removed until we migrate the name-only link feature from another plugin

# UI Improvments

## Dashboard View Link

Clicking on the dashboard page icon will view the page instead of the opening the editor. ![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/02.grav-admin-power-tools/dashboard_view_link.png)

## Navigate To Parent

An *Up* action has been added to the edit-page titlebar actions. It will not appear on top level pages. ![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/02.grav-admin-power-tools/nav-up.png)

## Smooth Scrolling

This plugin enables the navigation sidebar of the *Learn2 Theme* to have smooth scrolling on iOS and Android touch devices.

## Menu Scrolling

This plugin updates the admin titlebar menu to enable scrolling. ![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/02.grav-admin-power-tools/scrolling%20titlebar.png)

todo: The current Grav implementation uses a CSS styling for drop down menus that will not allow this feature to work.

# New +Add menu commands

This plugin adds additional options to the *+Add* dropdown. An *+Add* dropdown menu is also added to the dashboard.

Many of the dialog options are not yet implemented.

Copy Page ...Select a page to duplicate, and choose options.Add Page Like ...Create a new page like one from a selection and choose options.Add Page Like ThisCreate a new page like the current page.Add Page Like ParentCreate a new page like the current page's parent page.Add Page Like ChildCreate a new page like the current page's first child.Add Child PageCreate a new page like the current page, but set it's parent to the current page. Useful when starting the first child page of a parent.Page and Pages Menus ![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/02.grav-admin-power-tools/add%20page.png)

Dashboard Menu ![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/02.grav-admin-power-tools/add%20menu%20added%20to%20dashboard.png)

Copy Dialog ![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/02.grav-admin-power-tools/copy%20page.png)

Add Dialog ![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/02.grav-admin-power-tools/add%20like.png)

# Reports

A reports action is added to the Admin sidebar menu and displays a list of registered reports.

These reports are very basic, ugly, and are intended to be a simple *proof-of-concept* for the new *Reports API*.

## Standard Reports

- All Pages
- All Media
- All Links and Images
- Unused Media
- Missing Media
- Media By Page
- Page By Type
- Page References (grouped by internal/external and sorted alphabetically)
- Services
- Plugin Dependencies

todo: Add print functionality to reports 

todo: Add email functionality to reports 

todo: Add download functionality to reports 

todo: Standardize report CSS 

## Screenshots

![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/02.grav-admin-power-tools/reports%20sidebar.png)

The *All Links and Images* report displays all links and images used on the site, along with the pages that reference them. ![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/02.grav-admin-power-tools/links%20and%20images%20report.png)

The *Unused Media* report shows media that is not linked from Grav pages. ![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/02.grav-admin-power-tools/unused%20media.png)

The *Media By Page* report shows each page and the media in the page folder. ![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/02.grav-admin-power-tools/media%20by%20page.png)

Additional reports can be registered by the developer using the *report* service interface.

# Developer Tools

These tools are very experimental and not well-documented. Use them knowing that the API most likely will change.

## Twigs

The plugin adds additional twig functions to Grav.

### Admin

todo: add functions 

### Site

child\_page\_list()Returns a list of child pages as links.## Dialog Utilities

Enhancements for working with remodal dialogs have been added.

todo: : document remodal dialogs enhancements

## Form Widgets

### page-picker

This is a polymer-based widget that allows searching pages by name. Currently, AJAX is not used; (All the page names are initially sent to the client as data). The selected pages ID is used as the form data value.

Usage

```yaml
    section:
        type: section
        title: Move Page

    parentPageId:
      type: page-picker
      label: Page
      help: New parent page
      autofocus: true
      validate:
        required: true
```

![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/02.grav-admin-power-tools/page-picker.png)

### order-child

This is a widget for drag-and-drop support for child pages. It is based off of the Grav *sortable pages* field.

![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/02.grav-admin-power-tools/order.png)

### section

This is a override of the standard Grav section field with the addition of setting the generated element's tag name and style. The default has no style and a `p` tag.

| Parameters |  |  |  |
|---|---|---|---|
| Name | Description | Default |
| tag | The element to enclose the section in. | p |
| style | The style attribute value. | empty |

Usage

```yaml
   description:
      type: section
      style: color:darkgrey;margin:0 1em
      tag: div
      text: >
        When renaming references and titles, the rendered page output is checked.
        If it matches the page's route, the page is flagged.
        Pages with dynamic links will be flagged, 
        but since their source does not contain the link, they might still reference to the old route.
```

![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/02.grav-admin-power-tools/section-style.png)

## Full Screen Utilities

Several full-screen features, functions, and widgets are provided for developers.

todo: : document remodal dialogs enhancements

## Fast Filter

An API for blazing fast client-side element filtering is included. Simply specify your selectors and text to match.

This will hide all elements with the class *item* that do not contain the text *important*

```javascript
element_text_filter('.item', 'important');
```

This will hide all item-container classes that do not have visible sub items with the class *item*.

```javascript
visible_children_filter('.item-container', '.item');
```

By combining these 2 filters, you can filter items that contain text, and hide containers with no filtered items.

# Plugin Options

Features can be individually enabled on the plugin options page. ![](https://www.twelvetone.tv/docs/user/pages/03.developer-tools/06.grav-plugins/02.grav-admin-power-tools/power%20tools%20options.png)

 [ ](https://www.twelvetone.tv/docs/developer-tools/grav-plugins/grav-core-service-manager) [](https://www.twelvetone.tv/docs/developer-tools/grav-plugins/grav-editor-plugin)

---

## Navigation

- Parent: [Grav Plugins](https://www.twelvetone.tv/docs/developer-tools/grav-plugins.md)
- Previous: [Grav Core Service Manager](https://www.twelvetone.tv/docs/developer-tools/grav-plugins/grav-core-service-manager.md)
- Next: [Grav Editor Plugin](https://www.twelvetone.tv/docs/developer-tools/grav-plugins/grav-editor-plugin.md)