기술 블로그

WordPress에 반영하기 전에 바뀔 곳을 확인하는 방법

업데이트 · Get1pct Engineering

핵심 답변

사이트 운영자가 개선안 적용을 선택하면 WordPress의 현재 내용을 가져와 고칠 위치를 확인합니다. 대상이 분명할 때만 쓰고, 직접 고쳐야 하는 경우에는 문장을 복사해 쓸 수 있게 보여 줍니다.

연결과 대상 좁히기

WordPress 애플리케이션 비밀번호는 암호화해 보관하고, 등록된 호스트에 HTTPS로 REST API를 호출할 때만 씁니다. 적용할 때는 구독 상태와 개선안의 페이지가 그 사이트에 속하는지 확인합니다.

글과 페이지는 WordPress가 돌려주는 URL과 대조합니다. 홈페이지는 WordPress의 첫 페이지 설정을 읽습니다.

현재 값에서 변경 계획 세우기

제목과 설명은 원래 문장이 현재 값과 일치해야 합니다. 본문을 고칠 때는 HTML을 분석해, 화면에 보이는 텍스트 노드 안에서 조건에 맞는 위치가 한 곳뿐인지 보고, 변경 전후로 텍스트가 아닌 노드의 수가 같은지 비교합니다.

본문에 쓰려면 HTML을 그대로 저장할 수 있는 권한도 필요합니다. 공개된 HTML에 알려진 페이지 빌더의 표시가 있거나 원래 문장이 조건에 맞는 위치 두 곳에 있으면, 운영자가 편집 화면에 복사해 넣을 수 있게 문장을 보여 줍니다.

저장 결과 확인과 되돌리기의 한계

쓰기 전에 변경 계획을 기록하고, 응답으로 돌아온 저장 값을 기대한 값과 비교합니다. 다르면 이전 값으로 되돌리기를 시도하고 실패로 알립니다. 이 되돌리기 자체가 실패할 수도 있고, 그 사이에 들어온 다른 편집을 덮어쓰는 일을 완전히 막지는 못합니다.

되돌리기는 대상 항목 전체의 hash를 비교해, 쓴 뒤에 바뀌었으면 덮어쓰지 않습니다. 그래도 읽기와 쓰기 사이에 들어온 편집과는 충돌할 수 있습니다. 복사해서 직접 적용한 내용은 이 되돌리기의 대상이 아닙니다.

가상의 본문으로 따라가 보기

가상의 수리점 페이지 본문이 「<p>자전거를 수리합니다.</p>」로 저장되어 있다고 합시다. 원래 문장은 「자전거를 수리합니다.」, 바꿀 문장은 「자전거 정비를 맡겨 주세요.」입니다. URL이 일치하고, 원래 문장이 조건에 맞는 보이는 텍스트 노드 한 곳에만 있으며, 다른 조건도 통과하면 그 교체를 계획합니다. 계획이 곧 쓰기의 성공을 보장하지는 않습니다.

원래 문장이 두 번 나오면 어느 쪽인지 고를 수 없으므로 직접 복사하도록 안내합니다. 현재 값이 바뀌었거나, 지원하는 SEO 설명을 읽을 수 없거나, HTML을 그대로 저장할 권한이 없어도 자동 적용이 되지 않습니다. 개선안과 WordPress 편집 화면을 대조해 고칠 위치를 고르세요.

페이지를 확인하고 신중하게 되돌리기

적용하기 전에 URL과 두 문장을 확인하세요. 적용한 뒤에는 공개 페이지를 열어 바뀐 문장과 주변 화면을 봅니다. 캐시 때문에 방문자에게 늦게 보일 수 있으니 저장된 값과 공개 화면을 따로 확인합니다.

되돌리기에서 값이 바뀌었다고 나오거나 실패하면, 이후의 편집을 무작정 덮어쓰지 마세요. 현재 WordPress 항목과 사용할 수 있는 리비전을 비교하고, 사이트 관리자와 무엇을 되살릴지 정합니다. 자동 복원도 실패할 수 있으며, 직접 붙여 넣은 변경은 이 서비스의 되돌리기 대상이 아닙니다.

출처

View open roles