iBoard 가져오기
iBoard Import는 페이지 안에 하나 이상의 게시판 리스트를 출력하기 위한 숏코드 생성 기능입니다. 관리자는 게시판을 선택하고, Row, Length, Notice, Skin, Layer, Category, OrderBy 같은 옵션을 설정한 뒤 생성된 숏코드를 페이지에 붙여 넣을 수 있습니다.
이 기능은 게시판 리스트 코드를 직접 작성하지 않고, 페이지 안에 게시글 목록을 보여주고 싶을 때 사용합니다. 생성된 숏코드를 페이지에 넣으면 iBoard가 해당 옵션을 읽어 게시판 리스트를 자동으로 출력합니다.
화면 개요
iBoard Import 화면은 게시판 리스트 숏코드를 쉽게 만들기 위한 화면입니다. 코드를 직접 작성하지 않고 화면에서 게시판과 옵션을 선택하면, 시스템이 페이지에 붙여 넣을 수 있는 숏코드를 자동으로 생성합니다.
| 영역 | 설명 |
|---|---|
| Board Selection | 숏코드에 포함할 게시판을 하나 이상 선택합니다. |
| Import Settings | Row, Length, Notice, Skin, Layer, Page ID, Category, OrderBy 같은 출력 옵션을 설정합니다. |
| ShortCode | 페이지에 붙여 넣을 수 있는 생성된 숏코드를 보여줍니다. |
| Preview | 생성된 게시판 리스트가 어떻게 표시될지 확인합니다. |
이 기능이 하는 일
iBoard Import는 아래와 같은 숏코드를 생성합니다.
[list, row:10, lenth:30, notice:true, orderby:comment, layer:radix_boxton, id:1, Skin:NewsV]이 숏코드를 페이지에 넣으면 iBoard가 옵션을 읽고 해당 게시판 리스트를 화면에 출력합니다. 이를 통해 하나의 게시판 내용을 여러 페이지나 레이아웃에서 재사용할 수 있습니다.
Board Selection
Board Selection 영역에는 사용 가능한 게시판 목록이 표시됩니다. 숏코드로 출력할 게시판을 선택합니다.
| 옵션 | 설명 |
|---|---|
| 게시판 체크박스 | 숏코드에 포함할 개별 게시판을 선택합니다. |
| All | 사용 가능한 모든 게시판을 선택합니다. |
| Name | 가져올 수 있는 게시판 이름을 표시합니다. |
게시판을 선택하면 숏코드가 자동으로 생성되거나 갱신됩니다. 숏코드를 복사하기 전에 올바른 게시판이 선택되었는지 확인하세요.
Import Settings
Import Settings는 선택한 게시판 리스트가 어떻게 표시될지 결정하는 옵션입니다. 이 값들은 숏코드의 파라미터로 변환됩니다.
| 설정 | 숏코드 파라미터 | 설명 |
|---|---|---|
| Row | row |
목록 영역에 표시할 게시글 또는 행의 개수를 설정합니다. |
| Length | lenth |
목록에서 표시할 글자 수 또는 표시 길이를 설정합니다. |
| Notice | notice |
공지글을 포함하거나 표시할지 결정합니다. |
| Skin | Skin |
게시판 리스트를 표시할 스킨을 선택합니다. |
| Layer | layer |
숏코드에서 사용할 레이아웃 레이어 또는 표시 스타일을 선택합니다. |
| Page ID | pageid |
필요한 경우 특정 페이지와 연결합니다. |
| Category | category |
특정 카테고리의 게시글만 출력하도록 필터링합니다. |
| OrderBy | orderby |
최신순, 댓글순 등 지원되는 정렬 방식을 설정합니다. |
| Board ID | id |
선택한 게시판을 식별하는 값입니다. |
ShortCode 영역
ShortCode 영역에는 생성된 숏코드가 표시됩니다. 숏코드 영역 또는 복사 버튼을 클릭하여 생성된 값을 복사할 수 있습니다.
[list, row:10, lenth:30, notice:true, orderby:comment, layer:radix_boxton, id:1, Skin:NewsV]숏코드를 복사한 후 게시판 리스트를 보여주고 싶은 페이지 콘텐츠, 레이아웃 영역, 또는 숏코드를 지원하는 편집 영역에 붙여 넣으면 됩니다.
숏코드 예시
기본 게시판 리스트
[list, row:10, lenth:30, notice:false, orderby:nothing, layer:radix_boxton, id:1, Skin:NewsV]선택한 스킨과 레이어를 사용하여 ID 1번 게시판의 게시글 10개를 표시합니다.
공지글을 포함한 게시판 리스트
[list, row:10, lenth:30, notice:true, orderby:nothing, layer:radix_boxton, id:1, Skin:NewsV]게시판 리스트에 공지글을 포함합니다.
댓글 기준 정렬 게시판 리스트
[list, row:10, lenth:30, notice:true, orderby:comment, layer:radix_boxton, id:1, Skin:NewsV]지원되는 경우 댓글 기준 정렬 방식으로 게시판 리스트를 표시합니다.
카테고리별 게시판 리스트
[list, row:5, lenth:50, notice:false, orderby:nothing, layer:radix_boxton, id:1, category:news, Skin:NewsV]선택한 카테고리에 해당하는 게시글만 표시합니다.
사용 방법
- Admin > iBoard > Import 메뉴로 이동합니다.
- Board Selection 영역에서 하나 이상의 게시판을 선택합니다.
- Row, Length, Notice, Skin, Layer, Category, OrderBy 같은 Import 옵션을 설정합니다.
- ShortCode 영역에 생성된 숏코드를 확인합니다.
- 숏코드 영역 또는 복사 버튼을 클릭하여 숏코드를 복사합니다.
- 게시판 리스트를 표시할 페이지를 엽니다.
- 페이지 콘텐츠 또는 레이아웃 영역에 숏코드를 붙여 넣습니다.
- 페이지를 저장합니다.
- 미리보기에서 게시판 리스트가 정상적으로 출력되는지 확인합니다.
숏코드를 붙여 넣을 수 있는 위치
생성된 숏코드는 iBoard 숏코드 렌더링을 지원하는 영역에 붙여 넣을 수 있습니다.
- 페이지 콘텐츠 편집기
- Core Page 레이아웃 영역
- 게시판 레이아웃 섹션
- 스킨 또는 템플릿 콘텐츠 영역
- 숏코드 해석을 지원하는 커스텀 HTML 영역
숏코드가 게시판 리스트로 변환되지 않고 일반 텍스트로 보인다면, 붙여 넣은 위치가 숏코드 렌더링을 지원하지 않는 영역일 수 있습니다.
권장 작업 순서
- 어떤 게시판을 페이지에 표시할지 먼저 결정합니다.
- 해당 게시판이 활성화되어 있고 표시 가능한 상태인지 확인합니다.
- iBoard Import에서 게시판을 선택합니다.
- 올바른 Skin과 Layer를 선택합니다.
- Row와 Length를 설정합니다.
- 공지글을 포함할지 선택합니다.
- 정렬 방식을 선택합니다.
- 생성된 숏코드를 복사합니다.
- 대상 페이지에 붙여 넣습니다.
- 미리보기 후 필요하면 옵션을 조정합니다.
자주 사용하는 예시
| 사용 목적 | 권장 설정 |
|---|---|
| 홈페이지에 최신 소식 표시 | 뉴스 게시판을 선택하고 Row를 5 또는 10으로 설정한 뒤 뉴스형 스킨을 사용합니다. |
| 랜딩 페이지에 공지글 표시 | notice:true로 설정하고 공지 게시판을 선택합니다. |
| 인기글 표시 | 지원되는 경우 orderby:comment 같은 정렬 옵션을 사용합니다. |
| 특정 카테고리 글만 표시 | Category 값을 입력하고 게시글의 카테고리 값과 일치하는지 확인합니다. |
| 커스텀 페이지 안에 게시판 리스트 삽입 | 생성된 숏코드를 복사하여 페이지 편집기에 붙여 넣습니다. |
주의사항
- 선택한 게시판은 실제로 존재해야 합니다.
- 공개 페이지에 표시하려면 해당 게시판이 표시 가능한 상태여야 합니다.
- 선택한 Skin은 실제로 존재하고 해당 레이아웃을 지원해야 합니다.
- 선택한 Layer는 Skin과 호환되어야 합니다.
- Category 필터를 사용하는 경우 게시글의 카테고리 값과 일치해야 합니다.
- 지원하지 않는 영역에 숏코드를 붙여 넣으면 일반 텍스트로 보일 수 있습니다.
- 게시판 설정을 변경한 후에는 페이지를 다시 미리보기로 확인하세요.
문제 해결
| 문제 | 가능한 원인 | 해결 방법 |
|---|---|---|
| 숏코드가 텍스트로 보임 | 해당 영역이 숏코드 렌더링을 지원하지 않을 수 있습니다. | 숏코드를 지원하는 페이지 또는 레이아웃 영역에 붙여 넣습니다. |
| 게시판 리스트가 보이지 않음 | 게시판 ID가 잘못되었거나, 게시판이 숨김 상태이거나, 게시글이 없을 수 있습니다. | 게시판 ID, 표시 설정, 게시글 존재 여부를 확인합니다. |
| 원하는 디자인으로 보이지 않음 | 선택한 Skin 또는 Layer가 잘못되었을 수 있습니다. | 올바른 Skin과 Layer를 선택한 뒤 숏코드를 다시 복사합니다. |
| 공지글이 보이지 않음 | notice 옵션이 false이거나 게시판에 공지글이 없을 수 있습니다. | notice:true로 설정하고 공지글이 존재하는지 확인합니다. |
| 카테고리 필터가 동작하지 않음 | Category 값이 게시글의 카테고리 값과 일치하지 않을 수 있습니다. | 카테고리 철자와 게시글 카테고리 값을 확인합니다. |
| 정렬 방식이 바뀌지 않음 | 선택한 orderby 옵션이 스킨 또는 게시판 타입에서 지원되지 않을 수 있습니다. | 지원되는 정렬 옵션을 사용하거나 게시판 스킨 로직을 확인합니다. |
관리 권장 사항
- 숏코드 생성 전에 게시판 이름을 명확하게 정리하세요.
- 홈페이지 섹션에는 너무 많은 Row 값을 사용하지 않는 것이 좋습니다.
- 전용 게시판 목록 페이지에는 더 큰 Row 값을 사용할 수 있습니다.
- 페이지에 붙여 넣은 후 반드시 미리보기로 확인하세요.
- 중요 페이지에서 사용하는 숏코드는 별도로 기록해 두는 것이 좋습니다.
- 기존 숏코드에서 사용하는 스킨은 삭제하거나 이름을 변경하지 마세요.
- 옵션을 변경했다면 새로 생성된 숏코드를 다시 복사해서 사용하세요.
iBoard Import의 핵심은 게시판 리스트를 원하는 위치에 쉽게 재사용하는 것입니다. 게시판을 선택하고, 옵션을 설정하고, 생성된 숏코드를 복사해서 게시판 리스트가 필요한 페이지에 붙여 넣으면 됩니다.