WordPress 플러그인

Pellio 플러그인은 WordPress 6.5 이상과 PHP 8.1 이상이 필요합니다. 플러그인만으로도 동영상 플레이어로 작동하며, Pellio 계정에 연결하면 호스팅, 분석, 비공개 동영상 기능을 사용할 수 있습니다.

계정 없이 사용하기: Pellio 플레이어

Pellio Video 블록을 추가하고 YouTube나 Vimeo 링크를 붙여 넣거나, 미디어 라이브러리에서 동영상을 고르세요. 설정한 색상(Pellio → Settings → Player)의 Pellio 플레이어로 재생됩니다. 방문자가 재생을 누르기 전까지는 YouTube나 Vimeo에서 아무것도 불러오지 않으며, 썸네일은 사이트에 저장됩니다. YouTube, Vimeo, 미디어 라이브러리 동영상을 참고하세요.

Pellio 계정 연결하기

1. Pellio → Settings로 이동해 Connect to Pellio를 클릭합니다.
2. 요청이 나오면 로그인하고, 워크스페이스를 확인한 뒤 Connect site를 클릭합니다.

사이트 도메인이 워크스페이스의 허용 도메인에 추가되고, Pellio의 Settings → General → Connected WordPress sites에 사이트가 표시되며, 여기서 연결을 해제할 수 있습니다. 나중에 사이트 주소를 바꾸면 새 도메인이 자동으로 추가됩니다.

Pellio → Settings는 여러 섹션으로 이루어진 한 페이지입니다. 일부 섹션은 해당될 때만 표시됩니다.

• Player: 색상과 모서리 둥글기, Embeds(YouTube, Vimeo, 미디어 라이브러리 동영상 참고), Google Analytics, Viewer analytics(로그인한 사용자의 이메일 주소를 Pellio와 공유), Viewer watermark
• Automations: FluentCRM 또는 WP Fusion이 활성화되어 있을 때 표시됩니다. 자동화와 분석을 참고하세요.
• Courses: LMS가 활성화되어 있을 때 표시됩니다. 시청 증빙, 진행 보고서, 그리고 LearnDash, Tutor LMS, Sensei LMS용 Lesson videos 규칙이 있습니다.
• Access: Pellio를 사용할 수 있는 역할(아래 참고)
• Pellio account: 연결 상태와 Disconnect
• Status: Pellio 연결, 임베드 서명, 서버 시계, 허용 도메인, 콘텐츠 보안 정책(CSP), REST API, 캐싱 및 최적화 플러그인을 점검합니다. 결과는 10분 동안 유지되며, Run checks again을 누르면 새로 점검합니다. 같은 점검이 Tools → Site Health에도 하나의 테스트로 표시됩니다.

WordPress 대시보드에는 Pellio: top videos (30 days) 위젯도 추가됩니다.

Pellio 동영상 추가하기

• 블록 편집기: Pellio Video 블록을 추가한 다음 파일을 끌어다 놓거나 라이브러리에서 고르세요. 파일은 서버를 거치지 않고 브라우저에서 Pellio로 바로 업로드되며, 큰 파일은 업로드가 끊겨도 이어서 올라갑니다. 블록의 Playback 패널에는 Autoplay, Muted, Loop, Captions on by default, Start at (seconds)가 있습니다. Pellio Playlist 블록과 Pellio Lightbox 블록은 여러 동영상을 보여 주거나, 썸네일이나 버튼을 눌러 페이지 위에 동영상 하나를 엽니다.
• 클래식 편집기: 편집기 위의 Add Pellio video를 클릭하세요.
• 쇼트코드: [pellio id="VIDEO_ID"]에 선택적으로 title="", autoplay="1", muted="1", loop="1", captions="1", start="90", visibility="logged-in"(또는 visibility="members")를 추가할 수 있습니다. [pellio url="https://youtu.be/…"]는 YouTube, Vimeo 또는 파일 URL을 Pellio 플레이어로 재생하며, autoplay와 captions는 무시합니다.
• Pellio 링크: 편집기에 Pellio 공유 링크(pellio.io/v/…)를 붙여 넣으면 서명된 Pellio 플레이어로 바뀌며, 비공개 동영상도 재생됩니다.
• 페이지 빌더: Elementor 위젯, Bricks 요소, ACF 필드가 있습니다. 페이지 빌더, SEO, 캐싱을 참고하세요.

페이지에는 누군가 재생을 누를 때까지 가벼운 썸네일만 표시됩니다. 연결된 사이트에서 준비가 완료된 비공개가 아닌 Pellio 호스팅 동영상이 있는 페이지에는 검색 엔진을 위한 VideoObject 구조화 데이터도 포함됩니다.

WordPress에서 동영상 관리하기

Pellio → Videos는 WordPress 안의 Pellio 라이브러리입니다. 검색하거나 폴더별로 필터링하고, Upload videos를 클릭하거나 페이지 아무 곳에나 파일을 끌어다 놓으세요. 동영상을 열면 다음을 관리할 수 있습니다.

• Details(상세 정보): 제목, 설명, Who can watch(Public, Unlisted, Private), Folder, Copy shortcode, Replace file, Move to Trash
• Thumbnail(썸네일): Upload an image, Reset to default, 또는 Or use the frame at (m:ss) → Use this frame
• Chapters(챕터)와 Captions(자막, .vtt 또는 .srt)
• Analytics(분석): 7일, 30일, 90일, 12개월 중 선택한 Period의 재생 수, 재생률, 순 시청자 수, 평균 시청률과 함께 시청 지속률, Where it was watched(시청된 곳), Site members who watched(시청한 사이트 회원)

Trash 보기에는 휴지통으로 옮긴 동영상이 30일 동안 Restore 버튼과 함께 표시됩니다.

모든 사용자가 사이트의 연결을 함께 쓰므로 팀원마다 Pellio 계정이 필요하지 않습니다. Pellio → Settings → Access에서 Can upload and embed(업로드 및 임베드 가능, 기본값: Administrator, Editor, Author) 역할과 Can manage the library(라이브러리 관리 가능, 기본값: Administrator, Editor) 역할을 선택하세요. Administrator는 항상 두 권한을 모두 가집니다.

시청할 수 있는 사람

연결된 사이트의 임베드는 페이지를 볼 때마다 서명되므로, 비공개 동영상과 도메인 제한 동영상은 내 사이트에서만 재생되고 다른 곳에서는 재생되지 않습니다. 블록의 Access 패널에서 동영상을 로그인한 사용자나 선택한 요금제의 회원으로 제한할 수 있습니다. 로그인한 사용자는 분석에 시청자로 기록됩니다. Pellio → Settings에서 Viewer analytics를 켜면 이메일 주소도 공유되므로, 분석에 이름이 표시되고 이메일 양식을 건너뜁니다.

임베드 마이그레이션

Pellio → Migration은 두 부분으로 나뉩니다.

1. Vimeo, Wistia, YouTube 임베드 교체. Scan this site는 모든 게시물 유형과 사용자 정의 필드에서 iframe, Wistia 임베드, 쇼트코드와 단독 링크, Presto Player 블록, Media Hub 항목과 [presto_player] 쇼트코드, LifterLMS와 Sensei의 동영상 필드를 찾습니다. 어떤 동영상이 이미 Pellio 라이브러리에 있는지 보여 주므로, 먼저 Pellio에서 Vimeo나 Wistia 라이브러리를 가져오세요(동영상 가져오기 참고). Preview changes는 바뀔 내용을 보여 주고, Replace embeds는 실제로 교체합니다. 실행할 때마다 백업되어 Previous runs에 Undo와 함께 표시됩니다.
2. 미디어 라이브러리 동영상을 Pellio로 이전. Move videos to Pellio는 미디어 라이브러리의 동영상 파일을 Pellio로 업로드합니다. Also replace Video blocks and shortcodes that use them을 체크하면 해당 임베드도 함께 바뀝니다(백업되며 되돌릴 수 있습니다).

YouTube 임베드는 마이그레이션으로 교체되지 않습니다. Pellio는 YouTube에서 가져올 수 없으므로 원본 파일을 업로드해야 합니다. 대신 Pellio 플레이어로 재생하려면 Pellio → Settings에서 Use the Pellio player for YouTube and Vimeo embeds를 켜세요. Presto Player의 YouTube, Vimeo, 미디어 라이브러리 동영상은 바로 Pellio 플레이어로 바뀌고, Bunny.net 동영상은 가져오기가 끝나면 바뀝니다.

WP-CLI

wp pellio status                        # connection and migration summary
wp pellio scan [--format=table|json]    # embeds found, and which are in Pellio
wp pellio migrate --dry-run             # what would change
wp pellio migrate                       # replace embeds (backed up)
wp pellio rollback [run-id]             # undo a run; without an id, the latest
wp pellio offload [--limit=<n>] [--replace]   # move Media Library videos to Pellio
wp pellio evidence COURSE_ID > evidence.csv   # a course’s watch evidence

실행 ID는 Pellio → Migration의 Previous runs에 표시됩니다.

개발자용

• pellio_capability: 업로드 및 임베드, 또는 라이브러리 관리에 필요한 권한(capability)을 변경합니다.
• pellio_embed_atts: 렌더링 전에 임베드 속성(video, autoplay, start 등)을 변경합니다.
• pellio_video( $id, $atts ): 템플릿용 플레이어 HTML을 반환합니다.

제거하기

플러그인을 삭제하면 설정, 캐시, 예약된 작업이 삭제됩니다. WordPress에 저장된 학습자 정보, 즉 확인된 시청, 확인 서명, 코스 완료 표시, 자동화 기록도 함께 삭제됩니다. 다시 설치하면 이전 학습자의 시청 증빙 CSV에서 Watch verified, Attested, Signed as 열이 비어 있게 됩니다. Pellio 자체의 학습자 기록에는 모두 남아 있습니다. 게시물의 Pellio 블록과 쇼트코드는 그대로 유지되고, 마이그레이션 백업도 남아 있으므로 다시 설치해도 마이그레이션을 되돌릴 수 있습니다.