PHPackages                             softpromani/college-admin - 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. softpromani/college-admin

ActiveLibrary

softpromani/college-admin
=========================

Universal Master Admin Panel Package for College Management Systems with Auto-Discovery & Version Updates

v1.0.0(today)01↑2900%MITPHPPHP ^8.2CI failing

Since Aug 28Pushed todayCompare

[ Source](https://github.com/softpromani/CollegeMasterAdminPanel)[ Packagist](https://packagist.org/packages/softpromani/college-admin)[ RSS](/packages/softpromani-college-admin/feed)WikiDiscussions master Synced today

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

🎓 College Master Admin Panel (Laravel Package)
==============================================

[](#-college-master-admin-panel-laravel-package)

A universal, plug-and-play Master Admin Panel for College Management Systems. Install into any fresh Laravel project to automatically integrate full admin backend functionality (Notices, Events, Faculty, AQAR, Users, Roles & Permissions, DataTables, Media Gallery, Multi-language support) with built-in version tracking and one-command updates.

---

🚀 Features
----------

[](#-features)

- **Zero-Friction Integration**: Auto-discovered by Laravel.
- **Complete College Modules**:
    - Notices Management
    - Events & Event Galleries
    - Faculty & Non-Faculty Directory
    - Departments & Subject Mapping
    - Banners & Sliders
    - AQAR (Sessions & Criteria)
    - Spatie-powered User Roles & Permissions Matrix
    - Profile & Password Security
- **Version Tracking & Remote Update Alerts**: Informs administrators when newer releases are available on GitHub/Packagist.
- **One-Command Setup & Updates**: `php artisan college-admin:install` & `php artisan college-admin:update`.
- **Localization**: English (`en`) and Hindi (`hi`) support.

---

📦 Installation in Any Laravel Project
-------------------------------------

[](#-installation-in-any-laravel-project)

### 1. Require Package via Composer

[](#1-require-package-via-composer)

```
composer require college-admin/college-admin
```

*(For local/private package testing, add `"repositories": [{"type": "path", "url": "packages/college-admin"}]` in `composer.json`)*

### 2. Run the One-Step Installer

[](#2-run-the-one-step-installer)

```
php artisan college-admin:install
```

This command automatically:

1. Publishes configuration (`config/college-admin.php`).
2. Publishes static assets (CSS, JS, Fonts, Images) to `public/vendor/college-admin/assets`.
3. Runs all database migrations.
4. Seeds default roles, permissions, and administrator user.
5. Clears and warms application caches.

### 3. Access Admin Panel

[](#3-access-admin-panel)

Visit:

```
http://your-domain.test/admin

```

**Default Credentials:**

- **Email:** `admin@gmail.com`
- **Password:** `123456`

---

🔄 Versioning & Update System
--------------------------------

[](#-versioning--update-system)

### Version Constants

[](#version-constants)

The package version is defined in `CollegeAdmin\CollegeAdmin::VERSION` (e.g., `1.0.0`).

### In-Dashboard Update Notification

[](#in-dashboard-update-notification)

When you release a new version with a Git tag (e.g., `v1.1.0`), client installations will automatically detect the newer version via the `VersionChecker` service and display an alert banner in the dashboard.

### Applying Updates in Client Applications

[](#applying-updates-in-client-applications)

To update an existing college project to the latest release:

```
composer update college-admin/college-admin
php artisan college-admin:update
```

The `college-admin:update` command will:

- Re-publish fresh CSS/JS/images (`--force`).
- Run any newly added database migrations.
- Clear route, view, and config caches.

---

⚙️ Configuration (`config/college-admin.php`)
---------------------------------------------

[](#️-configuration-configcollege-adminphp)

```
return [
    // Version number
    'version' => \CollegeAdmin\CollegeAdmin::VERSION,

    // Custom route prefix and middlewares
    'route' => [
        'prefix' => env('COLLEGE_ADMIN_PREFIX', 'admin'),
        'middleware' => ['web', 'localization'],
        'name_prefix' => 'admin.',
    ],

    // Update checker configuration
    'updates' => [
        'check_enabled' => env('COLLEGE_ADMIN_CHECK_UPDATES', true),
        'github_repo' => env('COLLEGE_ADMIN_GITHUB_REPO', 'your-org/college-master-admin'),
        'cache_duration_hours' => 12,
    ],

    // Branding
    'branding' => [
        'app_name' => env('COLLEGE_ADMIN_NAME', 'College Master Admin'),
        'logo_path' => 'vendor/college-admin/assets/img/logo.png',
    ],
];
```

---

🛠️ How to Publish New Releases (For Package Maintainers)
--------------------------------------------------------

[](#️-how-to-publish-new-releases-for-package-maintainers)

1. Bump `VERSION` in `packages/college-admin/src/CollegeAdmin.php`: ```
    const VERSION = '1.1.0';
    ```
2. Commit and push: ```
    git add .
    git commit -m "Release v1.1.0 - Added new modules"
    ```
3. Tag the release: ```
    git tag v1.1.0
    git push origin v1.1.0
    ```
4. All client installations will now receive notification of the update in their admin dashboard!

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance100

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity45

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

Unknown

Total

1

Last Release

0d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/89004282?v=4)[Manish ](/maintainers/softpromani)[@softpromani](https://github.com/softpromani)

---

Top Contributors

[![manish-dev05](https://avatars.githubusercontent.com/u/237183332?v=4)](https://github.com/manish-dev05 "manish-dev05 (24 commits)")

### Embed Badge

![Health badge](/badges/softpromani-college-admin/health.svg)

```
[![Health](https://phpackages.com/badges/softpromani-college-admin/health.svg)](https://phpackages.com/packages/softpromani-college-admin)
```

###  Alternatives

[fleetbase/core-api

Core Framework and Resources for Fleetbase API

1239.7k25](/packages/fleetbase-core-api)

PHPackages © 2026

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