PHPackages                             issueconnector/submission-form-connector - 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 &amp; Helpers](/categories/utility)
4. /
5. issueconnector/submission-form-connector

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

issueconnector/submission-form-connector
========================================

Laravel Issue Submission Form Package

v1.0.1(3mo ago)00[15 issues](https://github.com/snehaaa162/issue-form/issues)MITPHP

Since Mar 11Pushed 3mo agoCompare

[ Source](https://github.com/snehaaa162/issue-form)[ Packagist](https://packagist.org/packages/issueconnector/submission-form-connector)[ RSS](/packages/issueconnector-submission-form-connector/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependenciesVersions (3)Used By (0)

Issue Submission Form Connector
===============================

[](#issue-submission-form-connector)

A Laravel package that provides a configurable issue submission form which creates issues in external providers like GitHub (with future GitLab support).

---

Features
--------

[](#features)

- 📋 Issue submission form
- ✅ Form validation with custom error messages
- 💾 Saves submissions to local database (two-table structure)
- 🐙 Creates issues in GitHub automatically
- 🔧 Fully configuration-driven
- 🎨 Publishable and overridable views
- 🔌 Provider abstraction for future GitLab support
- 📦 Auto-discovery support

---

Requirements
------------

[](#requirements)

- PHP 8.2+
- Laravel 12+
- MySQL

---

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

[](#installation)

Install the package via Composer:

```
composer require issueconnector/submission-form-connector
```

Laravel will auto-discover the package automatically.

---

Configuration
-------------

[](#configuration)

Publish the config file:

```
php artisan vendor:publish --tag=submissionform
```

Add the following to your `.env` file:

```
ISSUE_CONNECTOR_PROVIDER=github
GITHUB_TOKEN=your_github_token
GITHUB_REPO_OWNER=your_github_username
GITHUB_REPO_NAME=your_repo_name
GITHUB_API_URL=https://api.github.com
ISSUE_CONNECTOR_ROUTE=/submit-issue
ISSUE_CONNECTOR_STORAGE=true
ISSUE_CONNECTOR_QUEUE=false
```

---

Database Setup
--------------

[](#database-setup)

Run the migrations:

```
php artisan migrate
```

This will create two tables:

**`issue_submissions`** — stores core submission data:

- `id`
- `provider`
- `target_repository_or_project`
- `title`
- `body`
- `status`
- `timestamps`

**`issue_submission_meta`** — stores flexible key/value metadata:

- `id`
- `issue_submission_id`
- `meta_key`
- `meta_value`
- `timestamps`

---

Usage
-----

[](#usage)

Visit the form route in your browser:

```
http://your-app.com/submit-issue

```

Fill in the form fields:

- **Issue Title** — required
- **Description** — required
- **Repository / Project** — optional
- **Labels** — optional
- **Your Name** — optional
- **Your Email** — optional

Submit the form and the issue will be created in GitHub automatically!

---

Package Structure
-----------------

[](#package-structure)

```
submission-form-connector/
├── config/
│   └── issue-connector.php
├── database/
│   └── migrations/
├── resources/
│   └── views/
│       └── form.blade.php
├── routes/
│   └── web.php
└── src/
    ├── Contracts/
    │   └── IssueProviderInterface.php
    ├── DTO/
    │   ├── IssueData.php
    │   └── SubmissionResult.php
    ├── Http/
    │   ├── Controllers/
    │   │   └── IssueFormController.php
    │   └── Requests/
    │       └── SubmitIssueRequest.php
    ├── Models/
    │   ├── IssueSubmission.php
    │   └── IssueSubmissionMeta.php
    ├── Services/
    │   ├── IssueProvider.php
    │   ├── IssueSubmissionService.php
    │   └── ProviderManager.php
    └── PackageServiceProvider.php

```

---

Config Options
--------------

[](#config-options)

KeyDescriptionDefault`provider`Active provider`github``github_token`GitHub API token`""``github_repo_owner`GitHub repo owner`""``github_repo_name`GitHub repo name`""``github_api_url`GitHub API URL`https://api.github.com``route_path`Form route path`/submit-issue``route_middleware`Route middleware`['web']``storage_enabled`Enable DB storage`true``queue_enabled`Enable queue`false`---

Provider Abstraction
--------------------

[](#provider-abstraction)

The package is designed to support multiple providers. Currently GitHub is supported. To add GitLab support in the future, implement the `IssueProviderInterface`:

```
use IssueConnector\SubmissionFormConnector\Contracts\IssueProviderInterface;
use IssueConnector\SubmissionFormConnector\DTO\IssueData;
use IssueConnector\SubmissionFormConnector\DTO\SubmissionResult;

class GitLabProvider implements IssueProviderInterface
{
    public function createIssue(IssueData $issueData): SubmissionResult
    {
        // GitLab API implementation
    }
}
```

Then register it in `ProviderManager.php`:

```
'gitlab' => new GitLabProvider(),
```

---

Packagist
---------

[](#packagist)

---

License
-------

[](#license)

MIT

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance80

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

 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 ~0 days

Total

2

Last Release

107d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2252748f11cf6bc81f93461afa6883f5816b3856dd4cf563bad0b67b4802a47e?d=identicon)[snehaaa162](/maintainers/snehaaa162)

---

Top Contributors

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

### Embed Badge

![Health badge](/badges/issueconnector-submission-form-connector/health.svg)

```
[![Health](https://phpackages.com/badges/issueconnector-submission-form-connector/health.svg)](https://phpackages.com/packages/issueconnector-submission-form-connector)
```

###  Alternatives

[ueberdosis/tiptap-php

A PHP package to work with Tiptap output

26712.7M52](/packages/ueberdosis-tiptap-php)[typisttech/imposter-plugin

Composer plugin that wraps all composer vendor packages inside your own namespace. Intended for WordPress plugins.

155258.5k2](/packages/typisttech-imposter-plugin)[werkspot/sitemap-bundle

Bundle for generating dynamic sitemap.xml content with support for multiple sections

10185.5k](/packages/werkspot-sitemap-bundle)

PHPackages © 2026

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