WordPress 웹 사이트에 사용자 지정 코드를 안전하게 추가하는 방법

게시 됨: 2020-12-29

사용자는 종종 웹 사이트, 플러그인 및 테마를 조정하거나 기존 기능에 일부 수정 사항을 추가하는 방법을 찾고 있습니다. 대부분의 경우 WordPress 웹 사이트에 사용자 정의 코드를 추가하여 그렇게 할 수 있습니다.

웹사이트에 사용자 정의 코드를 추가하는 데 아무런 문제가 없습니다. 그러나 WordPress 웹 사이트를 변경할 때 주의해야 할 몇 가지 사항이 있습니다.

이 문서에서는 주의해야 할 사항과 WordPress 웹사이트에 사용자 지정 코드를 추가하는 모범 사례를 강조합니다.

WordPress에 사용자 지정 코드 조각을 추가하기 전에 확인해야 할 사항

작성자가 튜토리얼에서 제안한 코드 조각을 추가하는 가장 쉬운 방법은 테마의 functions.php 파일에 코드 조각을 추가하는 것입니다. 그러나 테마의 functions.php 파일에 코드 조각을 추가할 때 여러 가지 제한 사항과 단점이 있습니다.

테마를 업그레이드할 때마다 functions.php 파일에 추가한 사용자 정의 코드 조각은 수동으로 테마를 업그레이드하거나 한 functions.php 파일에서 다른 코드 조각으로 수동으로 복사하지 않는 한 덮어쓰게 됩니다. 대부분의 개발자가 특히 프리미엄 테마를 사용할 때 업그레이드를 매우 자주 릴리스한다는 점을 염두에 두고 테마의 functions.php 파일에 코드 조각을 추가하면 유지 관리가 매우 어려워집니다.

또한 테마를 변경하려면 코드도 마이그레이션해야 하므로 장기적으로는 확실히 좋지 않습니다.

또 다른 단점은 테마 파일이 모든 페이지에서 실행되고 테마의 functions.php 파일에 코드 조각을 추가하면 전체 웹사이트가 손상될 위험이 훨씬 더 높다는 것입니다.

WordPress 사이트에 사용자 지정 코드 조각을 추가하는 방법에 대한 모범 사례를 확인하여 테마를 업그레이드할 때 일부 코드 조각이 누락되거나 마이그레이션을 잊어버리거나 기능이 중단되는 것에 대해 다시 걱정할 필요가 없습니다.

WordPress 사이트에 사용자 정의 코드 조각 추가

다음 방법 중 하나를 사용하여 사용자 정의 코드를 추가할 수 있습니다.

  • 플러그인 사용(WordPress 플러그인이 무엇인지 자세히 알아보려면 WordPress 플러그인 소개 참조)
  • 커스텀 플러그인 만들기
  • 자식 테마 만들기

이제 각 방법에 대해 자세히 살펴보겠습니다.

1. 코드 조각 플러그인 사용

코드 조각 1 플러그인은 WordPress 사이트에 사용자 정의 코드를 추가하는 좋은 방법이며, 직접 코드를 작성하는 것을 좋아하지 않는다면 이 방법이 자체 플러그인을 만드는 것보다 쉽습니다.

플러그인을 설치한 후 새 스니펫 섹션이 WordPress 메뉴에 추가되어 새 스니펫을 추가할 수 있습니다. 각 스니펫에는 코드를 위한 공간과 코드가 하는 일에 대한 추가 정보에 대한 설명이 있습니다.

팁: 사이트의 유용한 코드 조각을 사용하는 경우 설명에 URL을 추가하여 코드의 출처를 기억하세요.

사용자 정의 코드의 예

플러그인과 마찬가지로 사용자 정의 코드 조각을 활성화 및 비활성화하고 PHP 파일로 내보낼 수 있습니다. 경우에 따라 사용자 정의 스니펫은 다른 플러그인 또는 테마와 충돌을 일으키므로 모든 사용자 정의 코드를 비활성화하는 것은 문제를 타겟팅하는 데 유용합니다.

2. 사이트별 플러그인 만들기

사용자 정의 사이트별 플러그인을 만드는 것은 코드를 완전히 제어할 수 있기 때문에 WordPress 사이트에 사용자 정의 코드를 추가하는 가장 좋은 방법입니다.

사이트별 WordPress 플러그인이란 무엇입니까?

사이트별 WordPress 플러그인은 테마에 의존하지 않는 웹사이트에 사용자 정의 코드를 추가하는 데 사용됩니다. 즉, 사용하는 테마에 관계없이 또는 테마 간에 전환하는 경우 플러그인이 활성화되어 있는 한 플러그인의 사용자 지정 코드가 항상 실행됩니다.

사이트별 WordPress 플러그인을 만드는 것이 더 나은 이유는 무엇입니까?

테마의 기능 파일에 사용자 정의 코드를 추가하면 테마를 업데이트하거나 전환하면 사라집니다.

사이트별 WordPress 플러그인을 사용하면 WordPress 사이트에 사용자 정의 코드 스니펫을 쉽게 추가하고 테마에 독립적인지 확인할 수 있습니다. 독립형 WordPress 플러그인입니다. 즉, 테마에 의존하지 않습니다. 즉, 사용자 정의 코드를 잃지 않고 테마를 자유롭게 업데이트하거나 전환할 수 있습니다.

사이트별 WordPress 플러그인을 만들기 위해 PHP 전문가가 될 필요는 없습니다. 아래의 쉬운 단계를 따르십시오.

1. 플러그인 디렉토리 생성

먼저 플러그인을 위한 디렉토리를 만들고 이름을 지정해야 합니다. 사이트의 웹 사이트와 같은 모든 이름이 될 수 있습니다. 플러그인의 디렉토리는 웹사이트의 /wp-content/plugins/ 디렉토리에 생성되어야 합니다. 이 예에서는 플러그인 wpwhitesecurity-shortcodes 를 호출합니다. 참고: 디렉토리 이름에는 항상 대시를 사용하고 공백은 사용하지 마십시오.

2. 플러그인 파일 생성

다음으로 플러그인의 기본 파일이 필요합니다. 파일 이름에 관한 규칙은 없지만 가장 좋은 방법은 파일 이름을 플러그인 이름과 동일하게 하는 것입니다. 따라서 이 예에서 플러그인의 파일 이름은 wpwhitesecurity-shortcodes.php 입니다.

이 파일은 최소한 제목과 설명을 포함해야 합니다.

NotePad ++ 또는 TextEdit와 같은 텍스트 편집기를 사용하여 이 파일을 만듭니다. Microsoft Word 또는 이와 유사한 편집기는 텍스트에 서식 데이터를 추가하고 파일을 엉망으로 만들 수 있으므로 사용하지 마십시오. 위에 나열된 모든 편집자는 무료입니다.

파일에 추가해야 할 사항은 다음과 같습니다.

<?php
/*
* Plugin Name: WP White Security Shortcodes
* Plugin URL: https://www.wpwhitesecurity.com
* Description: Site-specific plugin for custom code snippets in wpwhitesecurity.com
*/

그게 다야. 이제 사용자 정의 코드를 추가할 차례입니다.

3. 사용자 정의 코드 조각 추가

이제 자습서 등에서 코드 조각을 복사하여 이 파일에 붙여넣을 수 있습니다. 플러그인 파일을 오프라인으로 만든 경우 플러그인 폴더를 .zip 파일로 압축하고 WordPress 대시보드에서 웹사이트에 업로드합니다.

이제부터는 테마 또는 WordPress를 업그레이드할 때 일부 코드 스니펫이 누락되거나 마이그레이션을 잊어버리거나 일부 기능이 중단되는 것에 대해 걱정할 필요가 없습니다. 다음에 WordPress 코드 스니펫을 발견하고 이를 웹사이트에 추가하려는 경우 사이트별 플러그인 파일에 추가하십시오.

4. index.php 파일 추가(선택 사항)

이것은 선택적 단계입니다. 디렉토리 목록을 피하려면 플러그인 디렉토리에 색인 파일을 추가해야 합니다. 다음 작업만 하면 됩니다.

index.php라는 파일을 만듭니다.
여기에 다음 콘텐츠를 추가합니다.

<?php
/**
* Nothing to see here.

3. 하위 테마 functions.php 사용

이전에 테마의 functions.php 파일을 사용하지 말라고 했습니다. 그러나 이것은 특정 변경 사항(예: 테마별 변경 사항)에 대한 좋은 대안입니다. 이런 식으로 더 이상 필요하지 않으므로 테마가 있을 때 테마별 사용자 지정 코드가 표시됩니다.

그럼에도 불구하고 테마 변경 사항은 항상 상위 테마가 아닌 하위 테마에 추가되어야 하므로 업그레이드해도 안전합니다.

functions.php 에 코드를 추가하는 경우 항상 닫는 PHP 태그를 찾으십시오. ?> 와 같이 생겼습니다. 테마 파일이 이 중 하나로 끝나는 경우 그 위에 사용자 정의 코드를 넣어야 합니다.

하위 테마의 디렉토리 functions.php

결론

방금 보았듯이 WordPress 웹 사이트에 사용자 정의 코드를 추가하는 몇 가지 다른 방법이 있지만 모든 방법이 장기적으로 좋은 것은 아닙니다. 그러나 그들 중 일부는 특정 분야에서 다른 사람들보다 낫습니다. 예를 들어, 테마별 변경 사항(웹 사이트의 모양 및 느낌)의 경우 functions.php 파일에 사용자 정의 코드를 추가하십시오. 다른 변경 사항의 경우 이상적으로는 사용자 지정 사이트별 플러그인을 만들어야 합니다.

안전한 방식으로 WordPress에 사용자 정의 코드를 추가하고 문제가 발생하는 경우 쉽게 디버깅할 수 있도록 하십시오.
이 기사가 WordPress 사이트에 사용자 지정 코드 조각을 쉽게 추가하는 방법을 배우는 데 도움이 되었기를 바랍니다.

이 문서에 사용된 참조 [ + ]

이 문서에 사용된 참조
1 https://wordpress.org/plugins/code-snippets/