설명
atshift Fields는 기존 CFS 데이터를 잃거나 템플릿 호환성을 해치지 않으면서 구조화된 콘텐츠 편집이 필요한 워드프레스 사이트를 위한, 유지 관리 및 확장된 Custom Field Suite 호환 플러그인입니다. CFS()->get()을 포함한 익숙한 CFS API를 그대로 유지하면서, 보안 강화, 워드프레스/PHP 호환성 수정, 그리고 더 명확한 관리자 작업 흐름을 위한 실용적인 도구를 추가합니다.
버전 3은 콘텐츠가 많은 사이트에서 필드 관리를 훨씬 더 유연하게 만듭니다. 새롭게 디자인된 필드 그룹 편집기는 중첩 그룹, 드래그 앤 드롭 편집, 반응형 레이아웃, 다국어 관리자 레이블을 지원하므로, 큰 편집 화면을 더 쉽게 만들고, 검토하고, 유지 관리할 수 있는 방식으로 구성할 수 있습니다.
탭 그룹, 가로 그룹, 아코디언 그룹, 조건부 그룹, 그리고 반복은 복잡한 입력 화면을 집중된 섹션으로 나누고, 관련 필드를 나란히 배치하며, 관련 있을 때만 필드를 표시하고, 반복되는 콘텐츠를 깔끔하게 관리하는 데 도움이 됩니다.
버전 3에서는 게시물 제목, 콘텐츠, 저장 및 공개 제어, 카테고리, 태그, 대표 이미지, 게시물 편집 화면 표시 제어를 포함한 네이티브 워드프레스 필드를 필드 그룹에 추가합니다. 코드 보기, 쇼트코드 필드, 역할을 인식하는 편집 제어, 그리고 클래식 메타 박스 배치는 더 안전하고 유연한 실제 편집 워크플로를 위한 더 많은 옵션을 제공합니다.
설치 지침, 필드 값 출력 예시, 마이그레이션 노트 및 구현 예시는 atshift Fields 문서 사이트를 참조하세요.
알아두면 좋은 사항
- 이것은 공식 업스트림 릴리스가 아닌 유지보수 빌드입니다.
- 기존 CFS 설치를 교체하기 전에 항상 파일과 데이터베이스를 백업하세요.
- 유지보수 빌드를 활성화하기 전에 원본 Custom Field Suite 플러그인을 비활성화하세요.
- 프로덕션 사이트에서 사용하기 전에 로컬 또는 스테이징 사이트에서 테스트하세요.
- CFS는 저장된 값을 반환합니다. 테마 템플릿에서는 여전히 워드프레스 이스케이프 함수로 출력을 이스케이프해야 합니다.
- 추가된 필드 유형은 원본 상류 CFS 2.6.7 릴리스에서는 사용할 수 없습니다.
필드 유형
- 텍스트
- 텍스트 영역
- WYSIWYG
- 탭 그룹
- 루프(반복 가능한 필드)
- 수평 그룹
- 아코디언 그룹(접기/펼치기 그룹)
- 조건부 그룹
- 전화번호
- 이메일 주소
- 하이퍼링크
- URL
- 번호
- 선택
- 체크박스
- 참 / 거짓
- 라디오 버튼
- 날짜
- 시간
- 파일 업로드
- 사진 갤러리
- 색상
- Code 보기
- 쇼트코드
- Embed Code
- 클래식 메타 박스 배치
- 글 제목(워드프레스 기본 제목)
- 게시물 콘텐츠(워드프레스 기본 콘텐츠)
- 저장 / 공개 (네이티브 워드프레스 저장 및 공개 컨트롤)
- 글 카테고리 (표준 / 글로벌)
- 글 태그 (워드프레스 기본 태그)
- 대표 이미지(워드프레스 기본 대표 이미지)
- 항목
- 관계
- 사용자
이 유지 관리 빌드에 추가된 기능
- 알려진 CFS 2.6.7 취약점 유형에 대한 보안 강화.
- PHP 8.2+ 및 워드프레스 관리자 호환성 수정.
- 체크박스 및 라디오 버튼 필드.
- 형식 유효성 검사가 있는 전화번호, 이메일 주소, 숫자, URL 및 시간 필드.
- 시간과 분 선택 메뉴가 있는 시간 필드.
- 정렬 가능한 미디어 선택과 갤러리 친화적인 출력 데이터를 갖춘 사진 갤러리 필드.
- CFS 필드 그룹 안의 기본 워드프레스 글 제목, 글 콘텐츠, 저장 / 공개, 표준 및 공유 택소노미 글 카테고리, 글 태그, 그리고 대표 이미지 필드.
- 여러 필드를 나란히 배치하기 위한 수평 그룹 필드로, 균등 분배 및 왼쪽 정렬 레이아웃 옵션을 제공합니다.
- 접이식 섹션으로 하위 필드를 정리하기 위한 글 편집 화면용 아코디언 그룹 필드.
- 필드 그룹 편집기 버튼은 기존 필드 바로 아래 또는 루프, 가로 그룹, 아코디언 그룹 내부에 새 필드를 추가합니다.
- 탭, 루프, 가로 그룹, 아코디언 그룹에 대한 색상 코딩 구조 배지와 일치하는 범위 배경입니다.
- Field Group 편집기에서 드래그 앤 드롭과 Tab 경계 처리가 개선되었습니다.
- 선택한 유효하지 않은 필드로 스크롤하고, 해당 필드를 포함한 탭, 루프 또는 아코디언 그룹을 여는 인라인 검증 메시지와 오류 요약입니다.
- 공통 편집 작업 흐름별로 그룹화된 필드 유형 목록 순서.
- 중첩 필드가 글 편집 화면에서 사라지는 경우를 줄이기 위해 필드 그룹의 상위/하위 동기화.
- 배치 규칙이 없는 필드 그룹에 대한 배치 규칙 경고.
- 텍스트, 전화번호, 이메일 주소, 하이퍼링크, URL 필드에 대한 구성 가능한 플레이스홀더.
사용법
- ‘필드 그룹’ 관리자 메뉴로 이동합니다.
- 하나 이상의 사용자 정의 필드를 포함하는 필드 그룹을 만드세요.
- 배치 규칙 상자를 사용하여 필드 그룹이 표시될 위치를 선택하세요.
- 테마 템플릿에서 CFS get 메서드를 사용하여 사용자 정의 필드 값을 표시합니다.
예:
<?php echo esc_html( CFS()->get( 'my_text_field' ) ); ?>
리치 텍스트 필드의 경우, wp_kses_post()와 같은 적절한 HTML 살균기를 사용하세요.
탭 그룹 메모
탭 그룹은 글 편집 화면에서 필드를 탭 섹션으로 나누는 레이아웃 필드입니다.
해당 탭에 표시되어야 하는 필드 앞에 탭 그룹을 배치하세요. 또 다른 탭 그룹은 새로운 탭 섹션을 시작합니다.
가로 그룹 노트
Horizontal Group은 글 편집 화면에서 여러 하위 필드를 나란히 배치하는 레이아웃 필드입니다. 좁은 화면에서는 필드가 세로로 쌓입니다.
수평 그룹은 여러 개의 일반 필드를 포함하도록 설계되었습니다. 탭, 루프, 아코디언, 조건부 그룹 및 기타 수평 그룹은 수평 그룹 안에 배치할 수 없습니다.
아코디언 그룹 참고 사항
아코디언 그룹”은 게시물 편집 화면에서 접을 수 있는 섹션 안에 하위 필드를 배치하기 위한 레이아웃 필드입니다. 기본값으로 열리도록 설정할 수 있습니다.
탭은 아코디언 그룹 안에 배치할 수 없습니다.
조건부 그룹 노트
조건부 그룹은 게시물 편집 화면에서 선택한 라디오 버튼 또는 드롭다운 선택에 따라 서로 다른 하위 필드를 표시하는 레이아웃 필드입니다.
자식 필드는 필드 그룹 편집기에서 조건별 영역에 할당할 수 있습니다. 탭과 다른 조건부 그룹은 조건부 그룹 안에 배치할 수 없습니다.
클래식 메타 박스 배치 메모
클래식 메타 박스 배치는 클래식 서드파티 메타 박스를 atshift Fields 필드 그룹 내의 원하는 위치로 이동시키는 슬롯 필드입니다. 이 필드는 CFS 필드 값을 저장하지 않으며, 저장, nonce, 권한, 스크립트 및 스타일은 원래 메타 박스 플러그인의 책임으로 남습니다.
블록 편집기 전용 패널은 지원되지 않습니다. 기본 워드프레스 메타 상자와 내부 CFS 메타 상자는 이동하지 않는 것이 권장됨으로 표시됩니다.
원래 메타 박스 헤더는 배치 후 숨겨집니다. atshift Fields 필드 레이블과 नोट्स가 제목 역할을 제공하기 때문입니다. 표시 너비는 사이드 너비(320px), 50%, 75%, 또는 100%로 설정할 수 있으며, 좁은 화면에서는 항상 100% 너비를 사용합니다.
워드프레스 네이티브 필드 노트
게시물 제목, 게시물 콘텐츠, 저장 / 공개, 게시물 카테고리, 게시물 태그, 그리고 대표 이미지는 기본 워드프레스 오브젝트를 직접 수정합니다. 이들은 CFS 전용 게시물 메타 필드가 아닙니다.
글 카테고리의 경우, 하위 카테고리를 선택하면 상위 카테고리도 선택될 수 있으며, 상위 카테고리를 제거하면 해당 하위 카테고리 선택도 제거됩니다. 모든 카테고리가 제거되면 워드프레스의 기본값 카테고리가 복원됩니다.
보안 유지 관리 노트
이 패키지는 상위 2.6.7 코드베이스를 기반으로 로컬 보안 및 호환성 강화가 추가되어 있습니다.
유지 관리 작업은 Loop 필드 코드 실행, Term 필드 SQL 주입, CFS 폼 제목 / 콘텐츠 저장형 XSS, 그리고 정상적인 편집 권한 검사를 거치지 않은 CFS 폼을 통한 기존 게시물 업데이트와 관련된 알려진 취약점 유형을 해결합니다.
변경 사항은 내장 CFS 필드 유형, 추가된 필드 유형, 그리고 원본 2.6.7 코드베이스에서의 업그레이드 경로를 기준으로 로컬에서 검증되었습니다. 이 패키지는 또한 WordPress.org 플러그인 디렉터리에 맞게 조정되었으며, 공식 WordPress.org SVN 릴리스 흐름을 통해 공개되었습니다. WordPress.org 공개는 독립적인 제3자 보안 감사의 대체가 아닙니다.
재배포 및 라이선스
이 유지보수 빌드는 상위 플러그인과 동일한 라이선스인 GNU General Public License 버전 2(GPLv2)로 배포됩니다. GPLv2에 따라 이 패키지와 수정된 버전을 포함한 수정본을 사용, 복사, 수정 및 재배포할 수 있습니다.
When redistributing this package, keep the GPLv2 license notice, preserve the original author attribution, include the source code, and make clear that this is a maintained and extended build by @shift.
문서 및 지원
Related Projects
- atshift User Profile Fields – organize WordPress user profile fields with a similar field-building experience.
- atshift Freeform Login beta – design the WordPress login screen and place a matching login form on site pages.
스크린샷





설치
- 기존 Custom Field Suite 설치를 교체하기 전에 파일과 데이터베이스를 백업하세요.
- 유지보수 빌드를 활성화하기 전에 원본 Custom Field Suite 플러그인을 비활성화하세요.
- 워드프레스 플러그인 디렉터리에서 atshift Fields를 설치하고 활성화하거나, 플러그인 폴더를
/wp-content/plugins/에 업로드하세요. - atshift 필드 / 필드 그룹 관리 화면을 엽니다.
- 필드 그룹을 만들고, 필드를 추가한 다음, 표시될 편집 화면에 대한 배치 규칙을 설정하세요.
- 저장된 필드 값을 표시하려면 테마 템플릿에서
CFS()->get()을 사용하세요.
자세한 가이드와 예시는 문서 사이트를 참조하세요.
FAQ
-
이것이 Custom Field Suite의 공식 후속작인가요?
-
atshift Fields는 GPLv2에 따라 배포되는 독립적인 비공식 호환 유지보수 및 확장 빌드입니다.
-
원래의 Custom Field Suite를 atshift Fields로 교체할 수 있나요?
-
많은 경우 그렇습니다. 플러그인은 주요 데이터 구조와 API 호환성을 유지하지만, 교체하기 전에 항상 사이트를 백업하고 스테이징 환경에서 테스트하세요.
-
atshift Fields는 원래의 Custom Field Suite API를 그대로 보존하나요?
-
네. 기존 테마에서 사용하는 주요 API를 그대로 보존합니다. 여기에는
CFS()->get(),get_field_info(),get_reverse_related(),save(),find_fields(),form()이 포함됩니다. -
번들로 포함된 번역은 무엇인가요?
-
The release package includes bundled translation files for ca, de_DE, en_GB, es_ES, fa_IR, fr_FR, hu_HU, it_IT, ja, ko_KR, nl_NL, pl_PL, pt_BR, ru_RU, tr_TR, zh_CN, and zh_TW.
-
문서는 어디에서 찾을 수 있나요?
-
설정 가이드, 출력 예시, API 노트, 구현 예시를 보려면 atshift Fields 문서 사이트를 확인하세요.
후기
이 플러그인에 대한 평가가 없습니다.
기여자 & 개발자
“atshift 필드 (Custom Field Suite 유지보수)”(은)는 오픈 소스 소프트웨어입니다. 다음의 사람들이 이 플러그인에 기여하였습니다.
기여자변경이력
3.0.5.1
- Fixed confirmation dialog cancellation so Loop row and Field Group field add/delete actions are not performed when cancelled.
- Confirmed compatibility with WordPress 7.1 RC3.
3.0.5
- Added confirmation prompts before adding Loop rows or Field Group fields, and before deleting fields in the Field Group editor.
- Added Translate and Output Reference links to the Plugins screen, and updated the author link to the atshift Fields documentation site.
3.0.4.3
- Added a Settings shortcut to the Plugins screen action links.
3.0.4.2
- Added a Close button to each Loop row action area.
3.0.4.1
- Fixed Save / Publish field submission so actions follow the native WordPress save flow, preventing unintended draft saves and unnecessary leave-page warnings.
- Fixed required Post Categories validation so the WordPress default category alone does not satisfy the requirement.
3.0.4
- Added a dedicated Embed Code field for iframe-based embeds such as maps, so sites that previously used text fields or textareas for embed code can migrate safely under the strengthened sanitization.
3.0.3.1
- Fixed Save / Publish field updates so published, scheduled, or private posts are not unintentionally moved to Pending Review when edited by users without publish capability.
- Fixed native Post Title field updates so existing slugs are preserved unless explicitly changed by WordPress.
3.0.3
- Improved layout refresh for WYSIWYG and auto-resizing textarea fields when Accordion, Conditional, or Loop sections become visible.
3.0.2.8
- Fixed WYSIWYG field output so escaped paragraph HTML is normalized before
CFS()->get()formatting. - Normalized escaped rich text HTML before saving WYSIWYG and native Post Content field values.
3.0.2.7
- Fixed WYSIWYG editor content display so paragraph HTML opens normally in the visual editor instead of appearing as escaped tags.
- Improved WYSIWYG editor font styling on admin edit screens.
3.0.2.6
- Improved field heading styling so labels stand out more clearly while following the user’s admin color scheme.
- Improved Loop row spacing, color-scheme-aware row styling, and safer row action controls.
- Improved Loop row heading behavior and added guidance for dynamic row labels.
- Improved required-field error feedback so users can more easily find and resolve validation errors.
- Added an Extra display setting for hiding Global Categories.
- Removed the default value setting from the Shortcode field.
- Fixed a WYSIWYG initialization warning that could interrupt later field scripts.
3.0.2.5
- Improved field placement when dragging fields into lower Tab Groups.
- Improved where the bottom “Add New Field” button places fields when Tab Groups are present.
- Fixed field addition issues when multiple Loop fields exist on the same field group.
- Improved mobile spacing for nested category items.
- Added a warning for empty Tab Group labels.
- Adjusted several edit-screen colors to follow the user’s admin color scheme.
- Improved Textarea height adjustment for saved long content.
- Added missing translations.
3.0.2.4
- Added warnings and safeguards for some sites with many fields where field values or placement rules may fail to save.
- Added an option to add categories from the Post Categories (Standard / Global) field.
- Other minor fixes.
3.0.2.3
- Improved native title settings, frontend visual editor fonts, Extras display settings, and Tab Group editing UI.
3.0.2.2
- 저장 / 공개 필드 상태 표시를 개선하여, 선택한 상태 변경 사항이 저장할 때만 적용되도록 했습니다.
- 공개 및 예약 작업을 위한 저장/공개 필드 레이블이 개선되었습니다.
- 저장 / 공개 필드에서 임시글 및 대기 중인 글에 대한 미리보기 버튼 지원을 추가했습니다.
- 자동 저장 요청이 저장 / 공개 필드 상태 변경을 적용하지 않도록 했습니다.
- 휴지통 링크의 저장 / 공개 필드에서 워드프레스 표준 왼쪽 정렬을 복원했습니다.
- 저장 / 공개 표시 설정에서 비밀번호 필드 위치를 수정했습니다.
- 번들된 번역 파일을 업데이트했습니다.
3.0.2.1
- Conditional Group” 필드에서 조건 선택을 필수로 요구하는 **옵션**을 추가했습니다.
- 필수 자식 필드가 포함된 경우 아코디언 그룹 제목에 필수 필드 표시를 추가했습니다.
- 카테고리 검색 상자와 선택 항목만 필터를 숨기기 위한 게시물 카테고리 옵션을 추가했습니다.
- 기본 카테고리 처리와 Post Categories 필드의 부모/자식 자동 선택 간 충돌을 수정했습니다.
- 저장 / 공개 필드 레이아웃과 시각적 표현을 다듬었습니다.
- 번들된 번역 파일을 업데이트했습니다.
3.0.2
- atshift Fields 필드 그룹 안에 클래식 서드파티 메타 박스를 배치할 수 있도록 클래식 메타 박스 배치를 추가했습니다.
3.0.1.1
- WordPress.org 릴리스 패키지에 포함된 번역 파일.
3.0.1
CFS()->get()를 통해 렌더링된 쇼트코드 출력을 반환하는 Shortcode 필드를 추가했습니다.- 역할 기반 쇼트코드 편집 제어를 추가했습니다. 권한이 없는 사용자는 해당 필드를 볼 수 없으며, 다른 필드를 저장할 때 기존 쇼트코드 값은 유지됩니다.
- 클래식 게시물 편집 화면 옵션 레이아웃을 1열로 강제하도록 하는 추가 표시 설정을 추가했습니다.
- 불필요한 기본 편집기 섹션을 섹션 수준의 역할 타겟팅으로 숨기기 위한 사이드 / 메인 추가 표시 설정이 추가되었습니다.
3.0.0
- 필드 그룹 편집기 UI를 재설계했습니다. 여기에는 그룹 계층 구조, 간격, 드래그 앤 드롭 동작, 반응형 레이아웃이 포함됩니다.
- Tab, Accordion, Loop, Horizontal, 및 Conditional 그룹의 중첩 구조를 명확히 했습니다.
- 드래그한 필드를 각 조건에 더 쉽게 할당할 수 있도록 조건부 그룹에 조건별 드롭 영역을 추가했습니다.
- 그룹 필드와 기본 워드프레스 필드에 대해 불필요한 수동 입력을 줄이기 위해 자동 필드 이름 처리를 추가했습니다.
- 게시물 제목, 게시물 콘텐츠, 저장 / 공개, 게시물 카테고리, 게시물 태그, 대표 이미지에 대한 개선된 워드프레스 기본 필드 지원.
- 저장 / 공개 상태, 공개 범위, 공개 날짜, 임시글, 공개, 업데이트 동작을 개선했습니다.
- 게시물 카테고리(표준 / 전역) 및 게시물 태그의 표시 및 선택 동작이 개선되었습니다.
- 포토 갤러리, 파일 업로드, 이미지 필드에 대한 관리자 미리보기 및 처리 기능이 개선되었습니다.
- 더 명확한 내보내기 / 가져오기 / 초기화 안내와 번역을 적용해 atshift Fields Tool UI를 업데이트했습니다.
- 개선된 배치 규칙, 추가 기능, 도구 설명, Select2/Selectize 표시, 그리고 관리자 UI 세부 사항.
- 필수 필드 및 그룹 구조 경고를 다듬어 문제를 더 쉽게 이해할 수 있도록 했습니다.
- 블록 편집기와 클래식 편집기 환경 모두에서 메타박스 호환성과 표시 안정성이 향상되었습니다.
- 원래 Custom Field Suite API 및 저장된 데이터를 그대로 유지하면서 내부 PHP/CSS/JavaScript를 정리했습니다.
- nonce 및 권한 확인을 포함한 관리자 저장 및 AJAX 처리 강화.
- 새 필드, 설정, 경고, 도구 화면에 대한 다국어 번역을 업데이트했습니다.
