글 목록 스킨은 list.skin.php 파일을 사용한다. 글 목록이 담긴 전역변수 $list 배열을 이용해 목록을 출력할 수 있다.

글 목록을 출력하는 주요 기능을 예시한 코드는 다음과 같다.

<table>
    <thead>
        <tr>
            <th>번호</th>
            <th>제목</th>
            <th>작성자</th>
        </tr>
    </thead>

    <tbody>
    <?php foreach($list as $idx => $article) { ?>
        <tr>
            <td><?= $article['num'] ?></dt>
            <td>
                <!-- 카테고리 -->
                <?php if ($is_category) { ?>
                    <a href="<?= $article['ca_name_href'] ?>"><?= $article['ca_name'] ?></a>
                <?php } ?>

                <!-- 제목 -->
                <a href="<?= $article['href'] ?>"><?= $article['subject'] ?></a>

                <!-- 댓글 수 -->
                <?php if (!!$article['wr_comment']) { ?>
                    댓글(<?= number_format((int) $article['wr_comment']) ?>)
                <?php } ?>

                <!-- 추천 수 -->
                <?php if ($is_good && !!$article['wr_good']) { ?>
                    추천(<?= $article['wr_good'] ?>)
                <?php } ?>
            </dt>
            <td><?= $article['name'] ?></dt>
        </tr>
    <?php } ?>
    </tbody>
</table>

<?php for ($i = 0; $i < count($list); $i++) { ?>
    제목: <?= $list[$i]['subject'] ?>
<?php } ?>

글 목록

제목과 링크

subject에는 글 제목, href에는 글 주소가 담겨있다.

<!-- 예시: 글 제목에 링크 걸기 -->
<a href="<?= $article['href'] ?>">
    <?= $article['subject'] ?>
</a>

<!-- 원본 제목: $article['wr_subject'] -->
강조 표시된 제목

<!-- 검색한 '표시'가 강조된 제목: $article['subject'] -->
강조 <b class="sch_word">표시</b>된 제목

카테고리

카테고리 이름: <?= $article['ca_name'] ?>

$is_category(bool) 전역변수로 카테고리 사용 여부를 확인하여 출력

<?php if ($is_category) { ?>
    카테고리 이름: <?= $article['ca_name'] ?>
<?php } ?>

ca_name_href 키로 카테고리로 검색하는 링크를 걸 수 있다. 게시판 검색 기능으로 카테고리 명칭으로 검색한 글 목록을 표시한다.

<a href="<?= $article['ca_name_href'] ?>">
    <?= $article['ca_name'] ?>
</a>

작성자

name에는 글쓴이의 정보를 보거나 부가 기능을 위한 메뉴를 표시하는 "사이드뷰" 기능을 위해 <span> 태그로 감싼 메뉴가 포함되어 있다. 사이드뷰 태그가 포함되지 않은 원본 이름은 wr_name에 담겨있다.

작성자: <?= $article['name'] ?>
작성자: <?= $article['wr_name'] ?>

<!-- 출력 -->
작성자: <span ...>작성자이름</span>
작성자: 작성자이름

작성일시

작성일시는 wr_datetime과 datetime, datetime2로 구분되어 날짜 표시 형식을 다르게 표시할 수 있다. datetime2는 작성 당일에는 시:분으로 표시되며, 작성 당일이 지난 글은 월-일로 표시된다.

작성일(년-월-일 시-분-초): <?= $article['wr_datetime'] ?>
작성일(년-월-일): <?= $article['datetime'] ?>
작성일(가변): <?= $article['datetime2'] ?>

<!-- 출력 -->
작성일(년-월-일 시-분-초): 2023-12-31 23:59:59
작성일(년-월-일): 2023-12-31
작성일(가변): 12-31 또는 23:59

조회 수

조회 수는 1천 단위 이상일 때 읽기 쉽게 표시하기 위해 number_format() 함수를 사용하면 좋다.

조회수: <?= $article['wr_hit'] ?>
조회수: <?= number_format((float) $article['wr_hit']) ?>

<!-- 출력 -->
조회수: 100010
조회수: 100,010

추천, 비추천

$is_good(bool), $is_nogood(bool)으로 추천, 비추천 기능의 활성화 여부를 확인하고 표시하는 것이 좋다.

<?php if ($is_good) { ?>
    추천 수: <?= $article['wr_good'] ?>
<?php } ?>

<?php if ($is_nogood) { ?>
    비추천 수: <?= $article['wr_nogood'] ?>
<?php } ?>

기능이 활성화 되어있고 추천/비추천 수가 있을 때(1 이상)만 표시하려면...

<?php if ($is_good && !!$article['wr_good']) { ?>
    추천 수: <?= $article['wr_good'] ?>
<?php } ?>

<?php if ($is_nogood && !!$article['wr_nogood']) { ?>
    비추천 수: <?= $article['wr_nogood'] ?>
<?php } ?>

댓글

댓글 수 : <?= $article['wr_comment'] ?>

댓글이 있는지 구분하려면 wr_comment 값을 확인하면 된다.

<?php if (!!$article['wr_comment']) { ?>
    댓글 수: <?= $article['wr_comment'] ?>
<?php } ?>

기타

위 예시에서 foreach() 반복문으로 $list를 순회하면서 $article에 담긴 변수를 이용해 글 목록을 출력할 수 있다.

목록 정렬

카테고리 목록

검색

페이징

게시물 수: <?= number_format((int) $total_count) ?>
공지사항 수: <?= number_format((int) $notice_count) ?>
전체 페이지 수: <?= number_format($total_page) ?>
현재 페이지: <?= number_format((int) $page) ?>
시작 열: <?= number_format((int) $from_record) ?>

echo $total_count; // 전체 또는 검색 결과의 게시물 수
echo $board['bo_count_write']; // 전체 게시물 수

echo $total_page; // 1234.0
echo (int) $total_page; // 1234
echo number_format((float) $total_page); // 1,234

링크

글 쓰기 페이지 링크는 $write_href 전역변수

<?php if ($write_href) { ?>
    <a href="<?= $write_href ?>">글 쓰기</a>
<?php } ?>

게시판 설정 링크는 $admin_href 전역변수

<?php if ($admin_href) { ?>
    <a href="<?= $admin_href ?>">게시판 설정</a>
<?php } ?>

RSS 링크는 $rss_href 전역변수

<?php if ($rss_href) { ?>
    <a href="<?= $rss_href ?>">RSS</a>
<?php } ?>

기타

원문: https://g5guide.github.io/make/skin/board/list.html (g5guide, CC BY-SA 4.0)