PHPackages                             wehaa/custom-links - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Admin Panels](/categories/admin)
4. /
5. wehaa/custom-links

ActiveLibrary[Admin Panels](/categories/admin)

wehaa/custom-links
==================

Adds custom links to Nova sidebar.

v0.1.1(6y ago)12493.6k↓14.4%5[3 issues](https://github.com/wehaa/custom-links/issues)MITHTMLPHP >=7.1.0

Since Jan 10Pushed 6y ago5 watchersCompare

[ Source](https://github.com/wehaa/custom-links)[ Packagist](https://packagist.org/packages/wehaa/custom-links)[ RSS](/packages/wehaa-custom-links/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)DependenciesVersions (3)Used By (0)

Add custom links to your nova navigation
========================================

[](#add-custom-links-to-your-nova-navigation)

This tool allows you to add a custom links as a section in your sidebar or a single top level link.

Installation
------------

[](#installation)

You can install the package in to a Laravel app that uses [Nova](https://nova.laravel.com) via composer:

```
composer require wehaa/custom-links
```

Then you must register the tool with Nova. This is typically done in the `tools` method of the `NovaServiceProvider`.

```
// in app/Providers/NovaServiceProvider.php

use Wehaa\CustomLinks\CustomLinks;

// ...

public function tools()
{
    return [
        // ...
        new CustomLinks(),
    ];
}
```

To publish the config file to `config/custom-links.php` run:

```
php artisan vendor:publish --provider="Wehaa\CustomLinks\ToolServiceProvider"
```

To add links to the navigation section you need to add entries to the `links` section in the config file.

```
return [
    'links' => [
        '{TEXT}' => [                           // Top level section title text
            '_can'    => '{PERMISSION}'         // The name of the permission
            '_icon'   => '{ICON}',              // SVG icon code (optional)
            '_url'    => '{URL}',               // URL (optional if _links is present)
            '_target' => '{TARGET}',            // Link target (optional)
            '_links'  => [                      // Section extra links (optional if _url is present
                '{TEXT}' => [                   // Sub section text
                    '_can'    => '{PERMISSION}' // The name of the permission
                    '_url'    => '{URL}',       // URL
                    '_target' => '{TARGET}',    // Link target (optional)
                ]
            ]
        ]
    ]
];
```

The included config file will add some links you can use as an example.

Authorization
-------------

[](#authorization)

If you would like to only expose your links to certain users, you may chain the `canSee` method onto your tool's registration.

```
// in app/Providers/NovaServiceProvider.php

use Wehaa\CustomLinks\CustomLinks;

// ...

public function tools()
{
    return [
        // ...
        (new CustomLinks)->canSee(function ($request) {
            return false;
        }),
    ];
}
```

In addition, you can add the key `_can` in the links array, including the child links as well. We will use the `can()` function to check if the user has the permission to see the links or not.

Please note that if you don't want any authorization checks, do not add the `_can` key.

```
return [
    'links' => [
        '{TEXT}' => [                           // Top level section title text
            '_can'    => '{PERMISSION}'         // Checks if the link and sublinks can be shown
            // ...
            '_links'  => [                      // Section extra links (optional if _url is present
                '{TEXT}' => [                   // Sub section text
                    '_can'    => '{PERMISSION}' // Checks if the link can be shown
                    // ...
                ]
            ]
        ]
    ]
];
```

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance15

Infrequent updates — may be unmaintained

Popularity44

Moderate usage in the ecosystem

Community13

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~247 days

Total

2

Last Release

2439d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/071080ffc3e6211f7087871e646e589a200ddbf7ca600bc5c45edc6257846016?d=identicon)[emilianotisato](/maintainers/emilianotisato)

![](https://www.gravatar.com/avatar/4d4f5fcfb93b1e04818018228849712e3d8d5016ecbf37a9ccca4f6a5a028394?d=identicon)[josemanuelsh](/maintainers/josemanuelsh)

---

Top Contributors

[![josemanuelsh](https://avatars.githubusercontent.com/u/7245728?v=4)](https://github.com/josemanuelsh "josemanuelsh (4 commits)")

---

Tags

laravelnovasidebar

### Embed Badge

![Health badge](/badges/wehaa-custom-links/health.svg)

```
[![Health](https://phpackages.com/badges/wehaa-custom-links/health.svg)](https://phpackages.com/packages/wehaa-custom-links)
```

###  Alternatives

[benjacho/belongs-to-many-field

belongsToMany nova representation in field.

158811.4k1](/packages/benjacho-belongs-to-many-field)[pdmfc/nova-action-button

A Laravel Nova field to run actions.

37733.0k1](/packages/pdmfc-nova-action-button)[khalin/nova-link-field

A Laravel Nova Link field.

31562.2k2](/packages/khalin-nova-link-field)[ebess/nova-collapsible-sidebar

A collapsible sidebar for Laravel Nova.

32313.2k](/packages/ebess-nova-collapsible-sidebar)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)