PHPackages                             cms-orbit/announcement - 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. [PDF & Document Generation](/categories/documents)
4. /
5. cms-orbit/announcement

ActiveLibrary[PDF & Document Generation](/categories/documents)

cms-orbit/announcement
======================

CMS Orbit announcement: document-based announcement content type for the Orbit admin engine.

4.0.2(1mo ago)03MITPHP ^8.3

Since Jul 5Compare

[ Source](https://github.com/cms-orbit/announcement)[ Packagist](https://packagist.org/packages/cms-orbit/announcement)[ RSS](/packages/cms-orbit-announcement/feed)WikiDiscussions Synced 1w ago

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

CMS Orbit Announcement
======================

[](#cms-orbit-announcement)

`cms-orbit/announcement`는 Orbit 문서 엔진 위에 구축된 공지사항 패키지입니다.
관리자에서는 `DocumentEntity` 기반 CRUD로 공지를 관리하고, 프런트에서는 목록/상세 공개 페이지와 사이트맵 URL을 함께 제공합니다.

주요 기능
-----

[](#주요-기능)

- `cms-orbit/core` 기반 문서형 공지 콘텐츠
- 다국어 `documents` / `document_contents` 저장 구조
- Orbit 관리자 CRUD 자동 등록
- 공개 목록/상세 페이지 제공
- 갤러리 첨부, 공개 시각(`public_at`), 공지 여부(`is_notice`) 지원
- 사이트맵/SEO 노출용 공개 URL 제공

설치
--

[](#설치)

```
composer require cms-orbit/announcement:^4.0
php artisan migrate
php artisan orbit:frontend-sync   # orbit:install 직후라면 생략 가능
npm run dev                       # 공개 Inertia 페이지 개발 시
```

`cms-orbit/core`가 먼저 설치·설정(`orbit:install`)되어 있어야 합니다.

Laravel Boost
-------------

[](#laravel-boost)

이 패키지는 `resources/boost/guidelines/announcement.md`, `resources/boost/skills/announcement-development/`를 제공합니다.

- Boost **최초 설정**: 호스트에서 `php artisan boost:install` 1회
- **이후**: `orbit:install` / `orbit:sync`가 이 패키지를 Boost에 등록하고 `boost:update` 실행 (Boost가 이미 설정된 경우)

호스트 설정
------

[](#호스트-설정)

작업필수 여부`composer require cms-orbit/announcement` + `php artisan migrate`**필수**`php artisan orbit:frontend-sync`**필수** (Core 설치 시 `orbit:install`이 이미 실행했다면 생략 가능)Inertia 브리지 TSX 수동 작성**불필요** — sync 명령이 `announcement/index`, `announcement/show` 생성Vite `@cms-orbit/announcement` alias**불필요** — sync 명령이 주입관리자 CRUD·공개 라우트·번역은 패키지 Service Provider가 자동 등록합니다. 호스트 `routes/web.php` 수정은 필요하지 않습니다.

빠른 시작
-----

[](#빠른-시작)

### 1. 관리자에서 공지 관리

[](#1-관리자에서-공지-관리)

설치 후 Orbit 관리자 `Documents` 섹션에 공지 엔티티가 자동 등록됩니다.
제목, 슬러그, 본문, 설명, 갤러리, 공개 시각, 승인 상태를 한 화면에서 관리할 수 있습니다.

### 2. 공개 페이지 연결

[](#2-공개-페이지-연결)

패키지는 다음 공개 라우트를 제공합니다.

- `announcements.index`
- `announcements.show`

기본 경로는 아래와 같습니다.

```
/announcements
/announcements/{slug}

```

### 3. Inertia 페이지 (자동)

[](#3-inertia-페이지-자동)

`php artisan orbit:frontend-sync`가 호스트 `resources/js/pages/announcement/*.tsx` 브리지를 생성합니다. 커스터마이징이 필요할 때만 아래처럼 직접 re-export 하세요.

```
export { default } from '@cms-orbit/announcement/pages/announcement/index';
```

```
export { default } from '@cms-orbit/announcement/pages/announcement/show';
```

어떤 데이터가 추가되나요?
--------------

[](#어떤-데이터가-추가되나요)

- 공지 전용 마이그레이션
- 공지 모델과 팩토리
- 관리자 Entity 설명자
- 공개 컨트롤러와 웹 라우트
- 한국어 번역 리소스

운영 팁
----

[](#운영-팁)

- `slug`를 비워두면 자동 생성 흐름을 사용할 수 있게 설계되어 있습니다.
- 공개 상세 URL은 엔티티의 `showUrl()`과 사이트맵 URL 생성에 함께 사용됩니다.
- 공개 시각과 승인 상태를 같이 써두면 발행 시점을 맞춘 운영이 수월합니다.

License
-------

[](#license)

MIT

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance91

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

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

Total

3

Last Release

42d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3d4228d7eaafb1a5b13e853f87189815feefd9c21f31363d08ec509c47f29d0a?d=identicon)[cms-orbit](/maintainers/cms-orbit)

---

Tags

laravelcmsdocument announcementorbit

###  Code Quality

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/cms-orbit-announcement/health.svg)

```
[![Health](https://phpackages.com/badges/cms-orbit-announcement/health.svg)](https://phpackages.com/packages/cms-orbit-announcement)
```

###  Alternatives

[statamic/cms

The Statamic CMS Core Package

4.9k3.8M1.2k](/packages/statamic-cms)[typicms/base

A modular multilingual CMS built with Laravel, enabling developers to manage structured content like pages, news, events, and more.

1.6k20.4k](/packages/typicms-base)[statamic/statamic

Statamic

832182.1k](/packages/statamic-statamic)[nasirkhan/laravel-starter

A CMS like modular Laravel starter project.

1.4k2.7k](/packages/nasirkhan-laravel-starter)[api-platform/laravel

API Platform support for Laravel

58190.1k21](/packages/api-platform-laravel)[ecotone/laravel

Ecotone for Laravel — CQRS, Event Sourcing, Sagas, Durable Workflows, and Outbox on top of Laravel Queue, via PHP attributes.

21327.3k4](/packages/ecotone-laravel)

PHPackages © 2026

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