{"id":28848784,"url":"https://github.com/combizera/changelog","last_synced_at":"2026-03-14T12:10:12.456Z","repository":{"id":299480767,"uuid":"1003193183","full_name":"combizera/changelog","owner":"combizera","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-16T19:43:08.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-16T20:15:21.445Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/combizera.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-16T19:12:01.000Z","updated_at":"2025-06-16T19:41:01.000Z","dependencies_parsed_at":"2025-06-16T20:15:25.193Z","dependency_job_id":"6911c465-f704-430d-a749-e18ee22634df","html_url":"https://github.com/combizera/changelog","commit_stats":null,"previous_names":["combizera/changelog"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/combizera/changelog","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/combizera%2Fchangelog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/combizera%2Fchangelog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/combizera%2Fchangelog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/combizera%2Fchangelog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/combizera","download_url":"https://codeload.github.com/combizera/changelog/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/combizera%2Fchangelog/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260823015,"owners_count":23068266,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-19T20:07:22.104Z","updated_at":"2026-03-14T12:10:12.451Z","avatar_url":"https://github.com/combizera.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/combizera/changelog\"\u003e\n    \u003cimg src=\"./docs/banner.webp\" alt=\"Laravel Changelog Package Banner\" style=\"max-width: 100%; height: auto;\" /\u003e\n  \u003c/a\u003e\n  \u003ch1\u003e📋 Simple Changelog Generator for Laravel\u003c/h1\u003e\n\u003c/div\u003e\n\n![Packagist Version](https://img.shields.io/packagist/v/combizera/changelog)\n![Downloads](https://img.shields.io/packagist/dt/combizera/changelog)\n![License](https://img.shields.io/github/license/combizera/changelog)\n![PHP Version](https://img.shields.io/packagist/php-v/combizera/changelog)\n\n**Laravel Changelog** is a simple package to **manage and display changelogs** for your Laravel projects in an efficient way.\n\n---\n\n## 🚀 Installation\n\nTo install via **Composer**, run the following command:\n\n```bash\ncomposer require combizera/changelog\n```\n\nAfter installation, run the install command to set up the package:\n\n```bash\nphp artisan changelog:install\n```\n\n---\n\n## 📌 What Gets Created\n\n🔹 **Database Table:**\n- ✅ **`changelogs` table** with proper indexes\n- ✅ **Migration file** with current timestamp\n\n🔹 **Model:**\n- ✅ **`app/Models/Changelog.php`** with useful scopes\n- ✅ **Fillable attributes** and proper casting\n\n🔹 **Available Fields:**\n- `version` (string) - Version number (e.g., \"v1.2.0\")\n- `release_date` (date) - When the version was released\n- `type` (enum) - Type of change: `new`, `improvement`, `fix`, `security`, `deprecated`\n- `title` (string) - Brief description of the change\n- `description` (text, nullable) - Detailed description\n- `is_published` (boolean) - Whether to show publicly\n\n---\n\n## 📚 How to Use\n\n### 1️⃣ **Create Changelog Entries**\n\nAfter installation, you can create changelog entries using the model:\n\n```php\nuse App\\Models\\Changelog;\n\nChangelog::create([\n    'version' =\u003e 'v2.1.0',\n    'release_date' =\u003e now(),\n    'type' =\u003e 'new',\n    'title' =\u003e 'Added dark mode support',\n    'description' =\u003e 'Users can now toggle between light and dark themes in the settings.',\n    'is_published' =\u003e true\n]);\n```\n\n### 2️⃣ **Query Changelog Entries**\n\nThe model includes useful scopes for filtering:\n\n```php\n// Get only published entries\n$changelogs = Changelog::published()-\u003eget();\n\n// Filter by type\n$fixes = Changelog::published()-\u003ebyType('fix')-\u003eget();\n\n// Get latest entries\n$latest = Changelog::published()\n    -\u003eorderBy('release_date', 'desc')\n    -\u003etake(5)\n    -\u003eget();\n```\n\n### 3️⃣ **Available Types**\n\nThe package supports these changelog types:\n- `new` - New features\n- `improvement` - Enhancements to existing features\n- `fix` - Bug fixes\n- `security` - Security-related changes\n- `deprecated` - Features being phased out\n\n---\n\n## 📊 Database Schema\n\nThe migration creates a table with the following structure:\n\n```sql\nid               - Primary key\nversion          - Version string (indexed)\nrelease_date     - Date of release (indexed)\ntype             - Enum: new|improvement|fix|security|deprecated (indexed)\ntitle            - Short description\ndescription      - Long description (nullable)\nis_published     - Boolean flag (indexed with release_date)\ncreated_at       - Timestamp\nupdated_at       - Timestamp\n```\n\n---\n\n## 🔧 Model Scopes\n\nThe `Changelog` model includes these helpful scopes:\n\n```php\n// Only published entries\nChangelog::published()\n\n// Filter by specific type\nChangelog::byType('fix')\n\n// Combine scopes\nChangelog::published()\n    -\u003ebyType('new')\n    -\u003eorderBy('release_date', 'desc')\n    -\u003eget()\n```\n\n---\n\n## 🤝 Contributing\n\nWant to help **improve** this package?\n\n1. **Fork** the repository\n2. Create a **feature branch**:\n   ```bash\n   git checkout -b feat/#issue-number-feature-name\n   # Example: git checkout -b feat/#42-add-web-interface\n   ```\n3. Make your changes and **commit**:\n   ```bash\n   git commit -m \"feat(Model): Add version scope\"\n   ```\n4. Submit a **pull request** and wait for review!\n\nFeel free to **open issues** for questions or suggestions! 🚀\n\n---\n\n## 🛣️ Roadmap\n\n- [ ] Web interface for viewing changelogs\n- [ ] RSS feed generation\n- [ ] Markdown export functionality\n- [ ] Git integration for automatic changelog generation\n- [ ] API endpoints for changelog data\n\n---\n\n## 📝 License\n\nThis project is licensed under the **MIT License**. Feel free to use and modify it as needed.\n\nLong live **Open Source**! 🎉\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcombizera%2Fchangelog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcombizera%2Fchangelog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcombizera%2Fchangelog/lists"}