본문으로 건너뛰기
가이드

검색에서 앱 찾기

검색 가능한 메뉴와 인가된 리소스를 사용합니다.

검색에서 앱 찾기

검색 가능한 메뉴 목적지는 명령 팔레트에도 나타납니다. 생성된 Note 메뉴가 이미 있다면 새 contributor를 중복 추가하지 말고 기존 선언을 수정하세요. 새 화면은 기존 navigation contribution에 아래 값을 추가할 수 있습니다.

목적지 선언

코드 예시
PHP
use Nexia\Navigation\NavigationItem;

// Inside an existing NavigationContribution::navigationItems().
NavigationItem::make(
    id: 'workshop-notes',
    route: '/apps/workshop/notes',
    labelKey: 'workshop.note.list.title',
    appKey: 'workshop',
    contextId: 'app',
    permission: 'workshop.note.read',
    searchable: true,
);

등록한 프런트엔드 route와 번역 라벨을 유지하고 프로젝트 nexia dev로 동기화합니다. 워크스페이스 자격 증명 및 접근에서 조회 권한을 부여하세요. 전체 클래스 형태는 메뉴 목적지 추가를 참고합니다.

검색·열기 확인

팔레트에서 해당 언어의 화면 이름을 검색해 실제 App 화면이 열리는지 확인합니다. 권한 없는 사용자는 메뉴 발견과 API 조회 모두 거절돼야 합니다. searchable: false는 검색 배치만 숨기며 인가 기능이 아닙니다.

레코드 검색은 공개 Resource metadata와 resourceListFields()의 검색 필드를 사용합니다. 인덱스·설치 준비 상태에 따라 사용 가능 여부가 달라지고, Core가 후보 레코드를 다시 인가한 뒤 노출합니다. 별도의 무제한 검색이나 외부 인덱스 표시값으로 이 검사를 우회하지 않습니다.

사용자 정의 명령 구분

PHP SDK에는 PaletteCommandContribution·PaletteCommand가 있지만 현재 샌드박스 catalog exporter는 앱 명령 contribution을 게시하지 않습니다. 인터페이스 구현만으로 관리형 샌드박스에서 명령이 제공된다고 가정하지 마세요. 화면 열기는 검색 가능한 메뉴, 쓰기는 보호된 화면 액션을 사용합니다. Composer 호스트 지원이 샌드박스 지원을 뜻하지는 않습니다. 이 제한은 사용자 정의 실행 명령에 해당하며 일반 메뉴 검색과는 별개입니다.

CLI 명령과 옵션은 공개 CLI 문서에서도 확인할 수 있습니다.

원본 위치: docs/developers/content/ko/platform-extensions/command-palette.md