설명
카테고리 글 나열하기에서는 [catlist] 쇼트코드를 사용하여 글 또는 페이지에서 카테고리별로 글을 나열할 수 있습니다. 페이지 또는 글을 편집할 때 텍스트에 쇼트코드를 직접 삽입하면 해당 글들이 나열됩니다. 기본 사용법은 다음과 같습니다:
[catlist id=1]
[catlist name="news"]
쇼트코드는 카테고리 이름 또는 아이디, 글을 표시할 순서, 표시할 글 수를 입력할 수 있습니다. 글 작성자, 날짜, 발췌문, 사용자 정의 필드 값, 심지어 콘텐츠까지 표시할 수도 있습니다! 표시할 항목과 표시 방법을 사용자 정의할 수 있는 많은 매개변수가 추가되었습니다. 전체 문서를 확인하여 다양한 사용 방법에 대해 알아보세요.
[catlist] 쇼트코드는 각 글/페이지에 다른 인수를 사용하여 필요한 만큼 여러 번 사용할 수 있습니다.↵
[catlist id=1 numberposts=10]
몇 가지 옵션이 있는 옵션 페이지가 있으며, 새로운 옵션은 필요에 따라 (타당성이 있는 한) 구현될 것입니다.
지침을 읽어보세요에서 사용 가능한 매개변수와 사용 방법을 알아보세요.
글 대신 카테고리를 나열하려면 다른 플러그인 카테고리를 나열을 사용하면 됩니다.
자주 묻는 질문은 여기에서 확인할 수 있습니다.
사용자 지정
표시할 여러 요소는 CSS로 스타일을 지정할 수 있습니다. 요소를 래핑할 HTML 태그와 이 태그에 대한 CSS 클래스를 정의할 수 있습니다. 문서에서 사용법을 확인하세요. 글을 표시하는 방법을 사용자 정의하는 많은 팁과 방법을 제공하는 이 멋진 튜토리얼을 확인할 수도 있습니다.
워드프레스를 CMS로 사용하고 여러 카테고리 글이 있는 페이지를 만들 때 유용합니다.
GUI
클레멘스 스타리브랫이 카테고리 글 나열을 위한 GUI를 만들었습니다. 워드프레스 텍스트 편집기의 멋진 시각적 인터페이스에서 쇼트코드를 만드는 데 도움이 됩니다. 확인해 보세요 ↵
목록 카테고리 글용 GUI
AJAX 페이지 매김
아약스 페이지 매김 기능은 클레멘스 스타리브랫의 애드온 플러그인에서 유지 관리됩니다. 확인해보세요:↵
LCP Ajax 페이지 매김
위젯
워드프레스 4.9부터 텍스트 위젯에서 쇼트코드를 사용할 수 있습니다. 따라서 표시 유형 > 위젯에 텍스트 위젯을 추가하고 카테고리 글 목록 쇼트코드를 작성하면 됩니다.
플러그인에는 기능을 위한 간단한 인터페이스로 위젯도 포함되어 있습니다. 원하는 만큼 위젯을 추가하고 표시 여부 페이지에서 사용 가능한 모든 옵션을 선택하기만 하면 됩니다. 쇼트코드의 모든 기능이 아직 위젯에 구현된 것은 아닙니다. 쇼트코드를 최대한 유연하게 사용할 수 있습니다.
위키와 Changelog에서 새로운 기능과 플러그인 개선 사항에 대한 정보를 읽어보세요.
동영상
일부 사용자가 플러그인 사용 방법에 대한 동영상을 만들었습니다(감사합니다, 정말 멋지세요!). 여기에서 확인하세요:
플러그인 지원
클레멘스 스타리브랫은 이 플러그인을 위해 멋진 코드를 많이 작성해 왔으므로, 이 플러그인이 유용하다고 생각하고 후원하고 싶다면 GitHub(https://github.com/sponsors/klemens-st)에서 그를 후원해 보세요.
여러분도 기부할 수 있는 PayPal 계정이 있습니다.
개발
개발은 Codeberg와 GitHub에서 추적되고 있습니다. 거기서 포크하고, 코딩하고, 풀 리퀘스트를 하고, 개선 사항을 제안하세요. 모든 워드프레스 플러그인이 Git에서 호스팅되는 날을 꿈꿔봅니다 🙂
플러그인 사용 방법에 대한 문서가 워드프레스닷컴의 글자 수 제한을 초과했기 때문에 텍스트가 잘렸습니다. 전체 문서는 위키에서 찾을 수 있습니다. 또한 txt 파일보다 읽고 유지 관리하기가 더 편합니다. 코드버그/GitHub 이슈에 대한 제안을 환영합니다!
플러그인 사용 방법에 대한 지침
아래에서 일반적인 쇼트코드 사용 사례를 확인할 수 있습니다. 글, 페이지, 사용자 정의 글 유형, 텍스트 위젯을 편집할 때와 쇼트코드를 지원하는 모든 “페이지 빌더” 플러그인에서 쇼트코드를 사용할 수 있습니다.
전체 문서에서 다음과 같은 더 많은 기능에 대해 알아보세요:
- 고급 글 선택 옵션 (날짜별, 검색어, 사용자 정의 필드, 글 유형, 사용자 정의 분류 등)
- 출력 사용자 지정(각 글의 날짜, 작성자, 발췌문, 썸네일 등 표시)
- 간단한 PHP 예제를 기반으로 직접 디자인한 사용자 정의 템플릿을 만들 수 있습니다.
최신 글 10개를 나열합니다:
[catlist]
나열된 글의 기본 개수는 10개이며, 이를 수정하려면 numberposts 매개변수를 지정해야 합니다:
[catlist numberposts=15]
개 카테고리의 글을 나열합니다:
[catlist name=Dogs]
아이디가 2인 카테고리의 글을 나열합니다:
[catlist id=2]
기본적으로 “글” 글 유형만 포함됩니다. 페이지를 나열하려면 다음을 사용합니다:
[catlist post_type=page]
글과 페이지 모두에 적용됩니다:
[catlist post_type="post,page"]
위의 옵션을 결합하면 “개” 카테고리에서 글과 페이지 등 15개의 항목을 나열하는 쇼트코드를 얻을 수 있습니다:
[catlist name=Dogs post_type="post,page" numberposts=15]
문서에서 찾을 수 있는 대부분의 매개변수를 함께 사용할 수 있습니다.
플러그인은 현재 글의 카테고리를 감지하여 목록에 사용할 수 있습니다:
[catlist categorypage=yes]
태그도 마찬가지입니다:
[catlist currenttags=yes]
각 글의 발췌문을 표시하려면 다음과 같이 하세요:
[catlist excerpt=yes]
각 글 옆에 날짜, 작성자 및 댓글 수를 표시하려면 이 옵션을 사용하세요:
[catlist date=yes author=yes comments=yes]
많은 요소에 대해 HTML 태그와 클래스를 지정할 수 있습니다. 이전 쇼트코드를 수정하고 원하는 태그와 클래스로 날짜와 작성자를 래핑해 보겠습니다:
[catlist date=yes date_tag=span date_class="my-date" author=yes author_tag=p author_class="my-author" comments=yes]
날짜별로 글을 정렬할 수 있습니다:
[catlist orderby=date]
title, author, ID를 사용할 수도 있습니다. 더 많은 옵션은 문서에 설명되어 있습니다.
플러그인은 페이지 매김도 지원합니다. 페이지당 원하는 글 수를 플러그인에 알려주려면 numberposts를 지정해야 합니다:
[catlist pagination=yes numberposts=5]
위키를 참조하세요: 페이지 매김에서 자세한 내용을 확인하세요.
모든 플러그인 기능, 사용 사례 및 쇼트코드 매개변수에 대한 자세한 설명은 전체 문서를 참조하세요.
설치
list-category-posts디렉터리를 wp-content/plugins/ directory에 업로드합니다.- 워드프레스 관리자 메뉴에 로그인하고 플러그인으로 이동하여 활성화합니다.
- 글 및/또는 페이지에 ‘[catlist]` 쇼트코드를 사용하세요.
- 카테고리 글 목록 위젯은 워드프레스 대시보드의 모양; 위젯 섹션에서 찾을 수 있습니다.
- 플러그인이 정보를 표시하는 방식을 사용자 정의하려면 위키의 HTML & CSS 사용자 정의 또는 템플릿의 섹션을 확인하세요.
FAQ
자주 묻는 질문은 여기에서 확인할 수 있습니다.
-
플러그인 사용 방법에 대한 지침
-
위키에서 확인하세요.
지원 포럼에서 새 주제를 열기 전에 지침과 FAQ를 읽어보세요.
-
위젯
-
위젯은 매우 간단하며 플러그인의 모든 기능을 구현하지는 않습니다.
워드프레스 4.9부터 위젯에서 쇼트코드를 사용할 수 있습니다. 이전 워드프레스 버전을 사용 중이라면 테마의 functions.php 파일에 이 코드를 추가하세요:
add_filter('widget_text', 'do_shortcode');그런 다음 블로그에 새 텍스트 위젯을 추가하고 쇼트코드를 위젯의 콘텐츠로 사용하기만 하면 됩니다.
-
HTML 및 CSS 사용자 정의
-
템플릿 시스템
-
글이 표시되는 방식을 사용자 정의하는 방법: 템플릿 시스템.
-
새로운 기능 요청, 버그 수정, 개선 사항
-
GitHub 이슈에 게시할 수 있습니다.
-
추가 질문
-
질문을 게시하기 전에 FAQ를 확인하시기 바랍니다. 지원 포럼 또는 GitHub에 새 이슈 추가에 질문을 게시할 수 있습니다.
후기
기여자 & 개발자
변경이력
전체 변경 로그는 CHANGELOG.md를 참조하세요.
0.94.0
- Addresses CVE-2026-0553.
- Addresses potential debug warning:
Undefined array key QUERY_STRING. Report: https://wordpress.org/support/topic/php-8-4-issue-2/ - Escapes html for thumbnail class.
0.93.1
sanitize_status에 도입된post_status관련 버그가 수정되었습니다. 이 버그를 발견하고 수정해 주신 Galen Charlton(@gmcharlt)에게 감사드립니다!
0.93.0
- 콘텐츠를 표시할 때 비밀번호로 보호된 필터를 건너뛰지 마세요.
- 일부 글은 사용자가 편집자 또는 관리자인 경우에만 표시되도록 post_status를 위생 처리합니다.
- 보고된 취약점을 해결합니다: CVE-2025-11377, 인증된(기여자+) 정보 노출. 심각도 점수: 4.3(중간). CVSS 벡터: CVSS:3.1/AV:N/AC:L/PR:L/UI:N/S:U/C:L/I:N/A:N. 조직: Wordfence. 취약점 연구원(들): 아티왓 티프라사하른(지틀라다)
이 취약점은 기여자 수준 이상의 액세스 권한을 가진 인증된 공격자가 잠재적으로 실행할 수 있는 위험도가 낮은 취약점입니다. 하지만 이 버전에서는 수정되어야 합니다.
0.92.0
starting_with매개변수에서 잠재적인 SQL 인젝션 방지 – CVE-2025-10163. 이렇게 하면 SQL 인젝션이 해결되어starting_with가 위키에 따라 작동하지만 이전 코드에서는[catlist starting_with="Hello"]와 같이 “Hello”로 시작하는 글만 반환하고 “H”로 시작하는 글은 반환하지 않는 것도 허용했습니다. 이 새로운 구현은 첫 글자만 중요하기 때문에 둘 다 반환하며, 이는 문서화된 내용이기 때문에 괜찮습니다.- 템플릿 파일 포함 보안이 개선되었습니다.
템플릿파일은 이름에 문자, 숫자,_및-만 포함할 수 있습니다. 또한 현재 테마의 디렉토리 아래list-category-posts디렉토리에만 위치할 수 있습니다.
0.91.0
- CVE-2025-47636을 해결하고 템플릿 시스템에 대한 로컬 파일 포함을 방지합니다. 이 코드는 템플릿 매개변수에서 ‘../’ 문자열이 포함된 모든 항목을 제거합니다. 템플릿 파일은
wp-content/themes/your-theme-folder아래의list-category-posts.
https://www.cve.org/CVERecord?id=CVE-2025-47636
0.90.3
- 대소문자를 구분하지 않고 tag_escape를 사용하여 스크립트 태그에 대한 xss 수정을 강화합니다.
0.90.2
- 0.90.0부터 저장된 교차 사이트 스크립팅에 대한 업데이트 수정 사항이 이제 모든 태그에 적용됩니다. 이 버전부터는 쇼트코드에서 요소의 태그를 설정할 때 스크립트를 태그로 사용할 수 없습니다.
0.90.1
- PHP 8.2 지원 중단 공지 수정
- 위젯 더보기 링크에서 빈 앵커 태그 제거하기
0.90.0
excerpt_tag='script'를 사용하여 저장된 사이트 간 스크립팅 문제를 수정합니다.
