PHPackages                             northwestern-sysdev/dynamic-forms-directory-search - 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. [Utility & Helpers](/categories/utility)
4. /
5. northwestern-sysdev/dynamic-forms-directory-search

ActiveLibrary[Utility & Helpers](/categories/utility)

northwestern-sysdev/dynamic-forms-directory-search
==================================================

Northwestern Directory Search component for Dynamic Forms

v2.1.1(1y ago)233.7k↑20.8%[7 PRs](https://github.com/NIT-Administrative-Systems/dynamic-forms-directory-search/pulls)MITPHPPHP ^8.2CI passing

Since May 4Pushed 1y ago4 watchersCompare

[ Source](https://github.com/NIT-Administrative-Systems/dynamic-forms-directory-search)[ Packagist](https://packagist.org/packages/northwestern-sysdev/dynamic-forms-directory-search)[ RSS](/packages/northwestern-sysdev-dynamic-forms-directory-search/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelogDependencies (4)Versions (32)Used By (0)

Northwestern Directory Search Component for Dynamic Forms [![PHPUnit Tests](https://github.com/NIT-Administrative-Systems/dynamic-forms-directory-search/actions/workflows/phpunit.yml/badge.svg)](https://github.com/NIT-Administrative-Systems/dynamic-forms-directory-search/actions/workflows/phpunit.yml) [![Coverage Status](https://camo.githubusercontent.com/3bafd6cc0cd92d26089239569b1c3f0ccebbcba8f3b5d915753ee881bee85ca7/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f4e49542d41646d696e6973747261746976652d53797374656d732f64796e616d69632d666f726d732d6469726563746f72792d7365617263682f62616467652e7376673f6272616e63683d646576656c6f70)](https://coveralls.io/github/NIT-Administrative-Systems/dynamic-forms-directory-search?branch=develop)
=======================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#northwestern-directory-search-component-for-dynamic-forms--)

This is a [Dynamic Forms for Laravel](https://github.com/NIT-Administrative-Systems/dynamic-forms) component that does a lookup in the Northwestern directory.

It provides both the form builder/presentation UI and a controller for doing the lookups.

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

[](#installation)

You should already be using Dynamic Forms for Laravel. These instructions assume you have already set it up.

You will need an app with access to Directory Search - Basic. You can request access in the API Service Registry. Your API key should exist in the `.env`:

```
DIRECTORY_SEARCH_API_KEY=

# This defaults to prod when it is not specified.
DIRECTORY_SEARCH_URL=https://northwestern-prod.apigee.net/directory-search

```

Once ready, you can install the component via Composer:

```
composer require northwestern-sysdev/dynamic-forms-directory-search
php artisan dynamic-forms:directory:install

```

You will need to make two further changes:

1. Add a route for the new controller, inside the existing Dynamic Forms route group:

    ```
    Route::get('directory/{search}', Controllers\DynamicFormsDirectoryController::class)->name('directory');
    ```
2. Register the UI component with the Formiojs library in your `resources/js/formio/index.js` file:

    ```
    import NuDirectoryLookup from "../directory-search";
    import NuDirectoryEditForm from "../directory-search/form";

    // . . . skip some lines, look for this comment & add the code below it:

    // -------------------------------------------------------------------------
    // If you want to load custom code (like additional components), do it here!
    // -------------------------------------------------------------------------
    Formio.use(NuDirectoryLookup);
    Formio.Components.components.nuDirectoryLookup.editForm = NuDirectoryEditForm;
    ```

    Then run Laravel Mix to rebuild with the new component.

The component will show up in the form builder in the advanced section. You can rearrange it in the menu like any other component.

Contributing
------------

[](#contributing)

Pull requests from members of the Northwestern community are welcome!

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance43

Moderate activity, may be stable

Popularity30

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity75

Established project with proven stability

 Bus Factor1

Top contributor holds 93.5% 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 ~69 days

Recently: every ~194 days

Total

21

Last Release

448d ago

Major Versions

v1.7.0 → v2.0.02024-03-28

PHP version history (2 changes)v1.0.0PHP ^8

v2.1.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/3d4678c8051de43c86bddf6aec2c570d07175ac1011296dd25b8e6e97a0af34b?d=identicon)[northwestern-sysdev](/maintainers/northwestern-sysdev)

---

Top Contributors

[![nie7321](https://avatars.githubusercontent.com/u/27235866?v=4)](https://github.com/nie7321 "nie7321 (43 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")[![mc0918](https://avatars.githubusercontent.com/u/40612477?v=4)](https://github.com/mc0918 "mc0918 (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/northwestern-sysdev-dynamic-forms-directory-search/health.svg)

```
[![Health](https://phpackages.com/badges/northwestern-sysdev-dynamic-forms-directory-search/health.svg)](https://phpackages.com/packages/northwestern-sysdev-dynamic-forms-directory-search)
```

###  Alternatives

[sqhlib/hanzi-convert

PHP中文繁简体字转换程序，支持繁体转简体或简体转繁体

12327.6k](/packages/sqhlib-hanzi-convert)[maxsky/lumen-app-key-generator

Set the application key in Lumen Framework.

1477.5k](/packages/maxsky-lumen-app-key-generator)[rockyjvec/onvif

Onvif IP camera library.

231.3k](/packages/rockyjvec-onvif)

PHPackages © 2026

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