


DX_mapfood 맛집 게시판 스킨 사용 설명서 (v1.3.2)
맛집 지도 게시판 스킨입니다. 글마다 분류·대표 점수·메뉴·주소를 적고, 지도에 핀으로 보여 주며, 회원이 별점을 남길 수 있습니다.
v1.2.0: 지도의 번호 핀을 누르면 정보 카드가 뜨고, 거기서 해당 맛집 글로 이동할 수 있습니다. v1.1.5: 목록의 평점순/최신순 버튼 모양을 바로잡고, 게시판 설명의 별표(**)가 그대로 보이던 것을 고쳤습니다. v1.1.1~v1.1.4: 주소 찾기를 카카오 주소 검색 팝업으로 바꿨고, 맛집 상세에 댓글을 넣었고, 버튼에 마우스를 올리면 글자가 사라지던 문제를 고쳤습니다. 나머지는 v1.1.0 정리 내용입니다.
| # | 조치 | 효과 |
|---|---|---|
| 0 | 지도 핀·목록 카드를 누르면 정보 카드 표시 (이름, 분류, 평점, 대표 메뉴, 주소, 상세 보기) | 핀을 누르면 그 맛집 정보가 지도 위에 뜨고, 「상세 보기」나 이름을 누르면 해당 글로 이동합니다. OpenStreetMap·카카오맵·네이버 지도에서 같은 모양입니다 |
| 0 | 평점순/최신순 버튼을 하나의 묶음으로 정리 | 선택된 쪽이 위쪽 분류 탭과 같은 색(검정 바탕·밝은 글자)으로 보이고, 테두리가 어긋나지 않으며, 마우스를 올려도 글자가 사라지지 않습니다 |
| 0 | 게시판 설명의 **굵게** 표시 처리 | 별표가 그대로 보이지 않고 굵은 글씨로 나옵니다 (HTML 태그는 계속 막아 둡니다) |
| 0 | 선택된 분류 탭의 개수 숫자 색 수정 | 다크 모드에서 숫자가 흐려 보이던 것이 또렷해집니다 |
| 0 | 등록 화면의 "주소 찾기"를 카카오 주소 검색 팝업(postcode.map.kakao.com)으로 교체 | 도로명 주소를 골라 정확하게 입력하고 지도 핀도 자동으로 찾습니다 |
| 0 | 맛집 상세 화면에 댓글 등록·표시·삭제 추가 (코어 댓글 기능 사용) | 게시판의 댓글 사용 설정을 켜면 맛집 글에 댓글이 달립니다 |
| 0 | 버튼에 마우스를 올리면 글자가 사라지던 문제 수정 | 등록 버튼의 배경이 투명하던 문제(예전 CSS 규칙 충돌)와 다크 모드에서 라임색 버튼 글자가 사라지던 문제를 고쳤습니다 |
| 1 | 목록·상세·등록 화면 상단을 편지함(DX_mailbox)과 같은 구조로 통일 (HOME/게시판명 줄, BOARD 라벨, 큰 제목, 설명) | 다른 스킨과 상단 위치·크기가 똑같이 맞습니다 |
| 2 | 바깥 감싸개를 nb nb-list-page / nb-view-page / nb-write-page로 변경 | 플러그인이 붙이는 출력(다운로드 통계 등)이 정상 표시됩니다 |
| 3 | 맛집 정보와 별점을 게시판 확장 필드(post_meta)에 저장 | 새 DB 테이블을 만들지 않습니다 |
| 4 | 예전 방식(제목 태그, 전용 테이블) 자료를 자동으로 읽고 옮김 | 기존 글과 별점이 사라지지 않습니다 |
| 5 | 지도 설정을 코어 설정 테이블에 저장 | 전용 설정 테이블이 필요 없습니다 |
| 6 | alert·confirm 창을 없애고 화면 안 안내와 "한 번 더 누르면 삭제"로 교체 | 팝업 차단과 상관없이 동작합니다 |
| 7 | 스킨 폭을 콘텐츠 영역 100%로 확대 | 좁은 가운데 정렬이 사라졌습니다 |
| 8 | LICENSE.md의 외부 소프트웨어 항목을 실제 사용 내용으로 정정 | 라이선스 안내가 정확해졌습니다 |
1. 설치
- zip을 PC에서 풀면
boards/skins/DX_mapfood폴더가 나옵니다. - FTP로 접속해 사이트의
boards/skins/안에DX_mapfood폴더를 통째로 올립니다. 이전 버전이 있으면 덮어씁니다. - 관리자 > 게시판 설정에서 맛집 게시판의 스킨을
DX_mapfood로 선택하고 저장합니다. - 브라우저에서 Ctrl+F5(강력 새로고침)로 한 번 열어 봅니다.
- 이전 버전(v1.0.0)에서 올리는 경우: 별도 작업은 없습니다. 목록이나 글을 처음 열 때 예전 자료가 자동으로 옮겨집니다.
2. 사용법
- 맛집 등록: 목록의 등록 버튼 → 분류, 대표 점수, 대표 메뉴(a/b/c 형식), 주소를 입력합니다. "주소 찾기"를 누르면 카카오 주소 검색 팝업 창이 열리고, 주소를 고르면 입력칸이 채워지며 지도에 핀이 자동으로 꽂힙니다. (브라우저의 팝업 차단은 허용해 주세요.) 핀 위치가 맞지 않으면 지도를 눌러 옮기세요. 주소를 직접 적고 엔터를 눌러도 위치를 찾습니다.
- 지도: 목록 위쪽 지도에 핀이 표시되고, 핀을 누르면 글로 이동합니다.
- 별점: 상세 화면에서 로그인한 회원이 점수를 남깁니다. 글쓴이 본인은 평가할 수 없습니다. 평균과 참여 인원이 표시됩니다.
- 지도 종류 설정(관리자): 목록 화면의 "지도 설정" 접이식 칸(관리자에게만 보임)에서 OpenStreetMap, 카카오맵, 네이버 지도 중 고르고 필요한 키를 입력합니다.
- 댓글: 상세 화면 아래에서 댓글을 쓰고 지울 수 있습니다. 관리자 > 게시판 설정에서 이 게시판의 "댓글 사용"이 켜져 있어야 보입니다. 로그인 필요 여부는 게시판의 댓글 권한 설정을 따르고, 비회원은 이름과 비밀번호를 적습니다. 본인 댓글과 관리자만 삭제할 수 있으며, 삭제 버튼도 한 번 더 눌러야 지워집니다. 답글 입력 칸은 없습니다. 댓글 사용이 꺼져 있으면 관리자에게만 안내 문구가 보입니다.
- 삭제: 삭제 버튼을 한 번 누르면 "한 번 더 누르면 삭제"로 바뀌고, 4초 안에 다시 누르면 삭제됩니다.
지도 핀을 눌렀을 때
- 핀을 누르면 지도 아래쪽에 정보 카드가 뜹니다. 카드에서 상세 보기 또는 맛집 이름을 누르면 그 글로 이동합니다.
- 목록의 카드(사진 부분 등)를 눌러도 같은 정보 카드가 뜨고 지도가 그 핀으로 옮겨 갑니다.
- 카드는 오른쪽 위 X 또는 키보드 Esc 로 닫습니다.
- 맛집 상세 화면의 작은 지도에는 카드가 나오지 않습니다(이미 그 맛집을 보고 있으므로).
3. 알아 두세요
- 코어의 게시판 확장 필드 기능(
extend/top/50_board_fields.php)이 있어야 합니다. - 사용하는 필드 이름:
mp_cat,mp_score,mp_menu,mp_addr,mp_lat,mp_lng. 별점은 글마다star_<회원번호>로 저장됩니다. - 예전 글은 목록·상세에 그대로 보입니다. 글을 수정해서 저장하면 확장 필드 방식으로 바뀝니다.
- 예전 전용 테이블(
dxmp_rating,dxmp_setting)은 자료를 옮긴 뒤에도 지우지 않고 남겨 둡니다. 정상 동작을 확인한 뒤 직접 삭제해도 됩니다. - 카카오 주소 검색은 주소 글자만 알려 주고 좌표는 주지 않습니다. 핀 위치는 설정한 지도(OpenStreetMap, 카카오맵, 네이버 지도)의 주소 검색으로 찾습니다. OpenStreetMap은 한국 주소를 못 찾는 경우가 있으니, 정확한 자동 핀이 필요하면 카카오맵이나 네이버 지도 키를 설정하세요.
- 지도는 인터넷이 필요합니다. Leaflet은 cdnjs에서, 지도 타일은 OpenStreetMap에서 불러옵니다. 카카오·네이버는 본인 키가 있을 때만 씁니다.
- 코어 파일은 수정하지 않았고, PHP 5.6부터 동작하도록 작성했습니다. 이 점검 환경은 5.6이 아니어서 5.6에서 직접 실행해 보지는 못했습니다.
4. 라이선스
- DesignOneX License 1.0을 따릅니다. 요약:
- 사용료 없이 쓸 수 있고, 기업·고객사 프로젝트 등 상업적 이용도 가능합니다.
- 본인 사이트·프로젝트에 맞게 소스·기능·CSS를 고쳐 쓸 수 있습니다.
- 원본을 다시 배포하거나 판매하는 것은 무료·유료 모두 금지입니다.
- 고쳐서 나누거나 팔고 싶다면 반드시 designonex.com에 올려서 배포해야 합니다.
- 공식 문서: https://designonex.com/notice/view/1787577858493247
- 스킨 폴더의
LICENSE.md에 전체 내용과, 함께 쓰는 외부 서비스(Leaflet, OpenStreetMap, 카카오·네이버 SDK) 안내가 있습니다. 이 외부 소프트웨어는 스킨에 포함되어 있지 않습니다.
5. 문제가 생기면
| 증상 | 확인할 것 |
|---|---|
| 등록 화면에서 저장이 안 됨 | 코어에 게시판 확장 필드 기능이 있는지, 화면의 빨간 안내 문구를 확인합니다 |
| 주소 찾기 팝업이 안 열림 | 팝업 차단을 허용하고 Ctrl+F5로 새로고침합니다. 브라우저에서 F12 > 콘솔을 열고 주소 찾기를 누르면 [DX_mapfood]로 시작하는 진행 기록이 나옵니다(어디서 멈췄는지 알 수 있습니다). 인터넷 연결과 사이트가 https인지 확인합니다. 열리지 않아도 주소를 직접 적고 엔터를 누르거나 지도를 눌러 핀을 꽂을 수 있습니다 |
| 지도가 비어 있음 | 인터넷 연결과 지도 종류 설정, 카카오·네이버는 키와 허용 도메인을 확인합니다 |
| 예전 글의 별점이 안 보임 | 목록이나 글을 한 번 열고 새로고침합니다. 그래도 안 되면 dxmp_rating 테이블이 남아 있는지 확인합니다 |
| 댓글 칸이 안 보임 | 관리자로 로그인하면 댓글이 꺼진 게시판에는 안내 문구가 나옵니다. 그래도 안 보이면 상세 화면에서 F12 > 콘솔을 열어 [DX_mapfood] 댓글: 로 시작하는 줄을 확인하세요(댓글 사용 켜짐/꺼짐, 권한 단계, 댓글 수가 적혀 있습니다) |
| 화면이 예전 그대로임 | Ctrl+F5로 새로고침하고 data/cache 안의 .cache 파일을 지웁니다 |
| 상단 모양이 다른 스킨과 다름 | 스킨 폴더가 완전히 덮어써졌는지, style.css와 assets/mapfood.css가 새 버전인지 확인합니다 |