워드프레스 테마 편집하기: functions.php 파일 편집하기

워드프레스 테마 functions.php

functions.php 는 워드프레스 테마 의 일부며 사용자가 기능을 정의, 추가 하는데 사용되는 파일이다. 이 파일을 다룰 줄 알면 사용 중인 테마가 지원하지 않는 기능도 추가 할 수 있고 버그나 동작을 스스로 수정할 수 있다.

최근 내 블로그에 사용 중인 Pen 테마의 무한 스크롤 기능 (스크롤을 맨 아래로 내리면 새 게시물이 불러와 지는 기능)이 동작하지 않아 이를 커뮤니티에 가지 올리며 지원을 받고자 했지만 나와 같은 케이스가 거의 없고 답변이 세월아 네월아 하여 스스로 해결하고자 결정 하여 이번에 이것저것 건드리게 되어 정리해보고자 한다.

Pen Theme Help & Support Site

[Pen] Support | WordPress.org

You must be logged in to create new topics.

콘텐츠

PHP 파일 이란?

PHP 파일은 PHP (PHP: Hypertext Preprocessor) 스크립트 언어로 작성된 텍스트 파일이다. PHP는 주로 웹 개발을 위해 사용되는 서버 측 스크립트 언어로, 동적인 웹 페이지나 웹 애플리케이션을 생성하는 데 사용된다. PHP 파일의 특징과 용도는 다음 같다.

파일 확장자: PHP 파일은 .php 확장자를 가지며. 이 확장자를 가진 파일은 PHP 코드를 포함하고 있으며, 서버에서 실행된다.
서버 측 스크립트: PHP는 서버 측 언어이다. 즉, PHP 코드는 웹 서버에서 실행되며, 클라이언트 측(예: 브라우저)에서는 직접 실행되지 않는다. 웹 서버는 PHP 코드를 처리하고, 그 결과를 HTML 형식으로 변환하여 클라이언트에게 전송한다.
동적 콘텐츠 생성: PHP는 데이터베이스와의 상호작용, 폼 데이터 처리, 세션 관리 등을 통해 동적인 웹 콘텐츠를 생성한다. 이를 통해 사용자마다 다른 정보를 보여주는 맞춤형 웹 페이지를 만들 수 있다.
HTML과의 통합: PHP 코드는 HTML 코드 내에 삽입될 수 있다. PHP 스크립트는 <?php’ ~ ?> 태그 사이에 작성되며, 이 태그들 사이에 있는 코드는 서버에서 PHP로 처리된다.
데이터베이스 연동: PHP는 MySQL, PostgreSQL, Oracle, Microsoft SQL Server 등 다양한 데이터베이스와 연동하여 사용된다. 이를 통해 웹 애플리케이션에서 데이터를 저장, 검색, 수정 및 삭제하는 기능을 구현할 수 있다.
플랫폼 독립성: PHP는 다양한 운영 체제와 호환되므로, Linux, Windows, macOS 등 다양한 서버 환경에서 실행될 수 있다.

PHP 파일은 웹 개발에서 매우 중요한 역할을 하며, WordPress, Drupal, Joomla 등 많은 인기 있는 콘텐츠 관리 시스템(CMS)과 프레임워크에서 사용된다. PHP 코드를 작성하고 실행하기 위해서는 PHP가 설치된 서버 환경이 필요하다.

functions.php 에서 수행 가능한 주요 작업

해당 파일에서 수행 가능한 주요 작업은 다음과 같다.

테마 설정: 테마의 기본 설정을 정의하고, 테마 지원 기능을 활성화 할 수 있다. 예를 들어, add_theme_support() 함수를 사용하여 썸네일, 사용자 정의 배경, 포스트 형식 등을 지원하도록 설정한다.
스타일과 스크립트 추가: wp_enqueue_style()과 wp_enqueue_script() 함수를 사용하여 테마에 CSS와 JavaScript 파일을 안전하게 추가한다. 이는 테마의 시각적 요소와 기능적 요소를 관리하는 데 중요한 요소다.
사용자 정의 기능 추가: functions.php 를 사용하여 사용자 정의 기능을 만들고, 이를 테마에 통합할 수 있습니다. 예를 들어, 특정 조건에서 코드를 실행하거나, 특정 콘텐츠를 동적으로 표시하는 기능을 추가할 수 있다.
후크와 필터 사용: WordPress는 후크와 필터 시스템을 사용하여 테마와 플러그인이 핵심 WordPress 기능을 수정할 수 있게 한다. functions.php 파일에서 이러한 후크와 필터를 사용하여 원하는 방식으로 WordPress의 기능을 변경하거나 확장할 수 있다.
사용자 정의 위젯 및 쇼트코드 생성: 사용자 정의 위젯이나 쇼트코드를 만들어 테마에 추가적인 기능을 제공할 수 있다.
테마 옵션 페이지 생성: 고급 테마에서는 functions.php 를 사용하여 사용자 정의 테마 옵션 페이지를 만들 수 있다. 이를 통해 사용자는 관리자 대시보드에서 테마 설정을 쉽게 관리할 수 있다.

functions.php 파일을 수정할 때는 주의가 필요하다. 잘못된 코드나 구문 오류는 사이트의 기능에 심각한 문제를 일으킬 수 있다. 따라서 새로운 코드를 추가하거나 변경할 때는 항상 백업을 유지하고, 사이트가 계속 정상적으로 작동하는지 확인해야 한다.

이를 위해서 권장 하는 방법은 원본 테마 밑에 자식 테마를 만드는 방법이다. (해당 방법은 이후 포스팅 할 예정)

워드프레스 테마 파일 편집기

해당 파일을 편집하는 방법은 다음과 같다.

1. 워드프레스 관리자 페이지 내 외모 → 테마 파일 편집기 접속

해당 화면에 접속하면 테마 편집 화면이 출력 된다.

2. 우측 상단의 편집할 테마 선택

3. 테마 파일 중 funcstions.php 를 찾아 선택

테마 파일 편집기가 보이지 않을 경우

카페 24로 워드프레스를 구축 했다면 처음에 테마 파일 편집기 메뉴가 비활성화 되어 있을 가능성이 높다. 그렇다면 이를 수정해 주어야 하는데 이 때 FTP를 통해서 워드프레스 관련 설을 수정할 수 있다.

FTP 를 통해 워드프레스 서버에 접속 하면 wp-config.php 파일이 바로 보인다. 이를 복사 해서 백업 파일을 만들어 둔 상태로 Notepad++ 과 같은 텍스트 편집기를 통해 연 후 DISALLOW_FILE_EDIT 부분을 찾아 FALSE 로 변경 or 주석 처리 해주면 된다.