많은 워드프레스 사용자들은 기능을 추가하거나 설정을 변경할 때 functions.php 파일을 편집하라는 말을 듣게 됩니다. 하지만 초보자 입장에서 php라는 말만 들어도 겁이나죠. 어려워보이고 괜히 잘못 건드렸다가 잘못될까봐 망설여집니다.
직접 php 파일을 건드는 이 방법은 초보자에게 위험할 수 있습니다. 작은 문법 오류 하나만 있어도 사이트 전체가 하얀 화면(White Screen of Death)으로 멈춰버릴 수 있기 때문입니다. 워드프레스 사용자들에게 가장 무서운 화면이죠. 게다가 테마가 업데이트되면 기껏 만들어놓은 코드가 사라질 수도 있습니다.
그러나 다행히 워드프레스에는 functions.php를 건드리지 않고도 코드 삽입이 가능한 안전한 방법들이 존재합니다. 이번 글에서는 초보자도 따라할 수 있는, functions.php 없이 코드 삽입하는 3가지 방법을 소개합니다. 이 방법들을 사용하면 사이트 안정성은 물론 유지관리도 훨씬 수월해집니다.
1. 코드 삽입 전, 반드시 확인할 점
코드를 삽입하기 전에는 항상 아래 사항을 확인해야 합니다.
- 어떤 종류의 코드인가? (PHP, JavaScript, CSS)
- 어디에 삽입할 것인가? (헤더, 본문, 푸터, 특정 페이지 등)
- 전역 적용인지, 특정 조건에서만 적용할 것인지
이 기준을 먼저 정리하면 어떤 방법을 선택할지 명확해집니다.
2. 방법 ① 코드 스니펫 플러그인 사용 (Code Snippets)
가장 추천되는 방법은 Code Snippets 플러그인을 사용하는 것입니다. 이 플러그인은 functions.php에 넣는 코드와 동일한 코드를 안전하게 웹 관리자 화면에서 추가할 수 있습니다.
장점
- 코드를 ‘이름’별로 정리 가능
- 활성화/비활성화 버튼 있음
- 문법 오류 발생 시 사이트가 멈추지 않도록 보호
사용법
- 플러그인 설치 → “Code Snippets”
- “새 스니펫 추가” 클릭
- 코드 입력 후 저장 및 활성화
이 플러그인을 사용하면 거의 모든 functions.php용 코드를 안전하게 삽입할 수 있습니다.
코드 스니펫 플러그인은 php외에도 애드센스 코드를 넣거나 서치콘솔 등록 등 헤더 부분에 코드를 쉽게 넣기 위해 대부분 설치하는 플러그인입니다. 이 플러그인으로 php도 자유롭게 편집이 가능하니 편리하게 이용하시면 됩니다.
3. 방법 ② 헤더/푸터 코드 삽입 플러그인 활용
Google Analytics, Facebook Pixel, 사용자 정의 스크립트 등은 주로 <head> 또는 <footer>에 삽입해야 합니다. 이때는 ‘Insert Headers and Footers’ 또는 ‘WPCode’ 플러그인을 사용하면 됩니다.
사용법
- 플러그인 설치 → “Insert Headers and Footers”
- 관리자 메뉴에서 설정 → ‘헤더/푸터’ 항목 클릭
- 코드 입력 후 저장
주요 활용 예시
- meta 태그 추가
- 외부 JS 스크립트 삽입
- 광고 코드 삽입
이 방법은 테마 파일을 건들지 않고도 간단하고 안전하게 작업할 수 있습니다.
4. 방법 ③ 사용자 정의 플러그인 직접 만들기
조금 더 고급 사용자라면, 간단한 ‘사용자 정의 플러그인’을 만들어 사용하는 방법도 있습니다.
제작 절차
wp-content/plugins/폴더에my-custom-functions.php파일 생성- 아래 기본 구조로 코드 작성
<?php
/**
* Plugin Name: My Custom Functions
*/
add_action('init', function() {
// 여기에 원하는 코드 작성
});
- 워드프레스 관리자 → 플러그인 → 활성화
이 방식은 코드가 테마와 분리되어 있어 유지관리가 편하며, 충돌을 줄일 수 있습니다. 어려워 보이기도 하지만 이 방법은 나만의 php 파일을 만들어 관리하기 때문에 유지 보수가 쉬울 수도 있습니다.
요약 및 마무리
functions.php를 직접 수정하는 방식은 초보자에게 위험할 수 있습니다. 위에서 소개한 3가지 방법 — Code Snippets 플러그인, 헤더/푸터 코드 삽입 플러그인, 사용자 정의 플러그인 — 중에서 자신의 기술 수준과 목적에 맞는 방법을 선택하면 훨씬 안전하게 워드프레스를 운영할 수 있습니다. 애드센스 코드 삽입, SEO 메타태그 삽입, 광고 스크립트 삽입 등 다양한 목적에 모두 활용 가능하므로, 이제는 functions.php 없이도 전문가처럼 사이트를 운영해보세요.
덤으로 자식 테마를 설치하고 코드 편집 메뉴에 들어가서 php코드를 추가하거나 수정할 수도 있습니다. 이 방법도 워드프레스 업데이트시 코드라 날아가지 않고 안전하게 이용할 수 있으니 앞서 설명드린 세 가지 방법에 플러스로 알아두세요.