ACF Functions

  • acf_add_options_page():
    새 옵션 페이지를 관리자 메뉴 사이드바에 표시, 전역변수
  • acf_add_options_sub_page():
    Options Page Add-on을 설치해야 한다. 새 하위 페이지를 관리자 메뉴에에 추가된다. 이 함수는 functions.php 파일 안에 사용된다. 반드시 ‘init’ action 앞에서 실행해야 한다. 주의: 업그레이드 시 이 functions.php는 사용할 수 없다. 웹 사이트가 다운되지 않도록  if function_exists statement 안에 이 함수를 사용하여야 한다.
  • acf_form():
    글을 추가하거나 업데이트하기 위한 폼을 만든다. 폼을 사용자 정의하기 위해 다양한 설정을 할 수 있고, 이것은  $options array에 추가하면 된다.
  • acf_set_options_page_capability()
  • acf_set_options_page_menu()
  • acf_set_options_page_title()
  • acf_settings:
    이 훅은 플러그인으로 ACF에서 사용하는 전역 변수을 덮어쓴다.
  • Shortcode:
    숏코드는 다른 필드 값을 표시하기 위해 위지위그(WYGIWYG )방식으로 작성할 때 사용된다.
  • BASIC
  • get_field_object() :
    이 함수는 필드 그룹 편집 화면에서 보이는 필드 객체를 반환한다.
  • get_field_objects() :
    특정 페이지 / 글을 위한 사용자정의 필드 객체의 배열을 반환한다. 이것은 wp_postmeta 테이블에 있는 모든 사용자정의 필드 값(“-“을 사용하지 않는다)을 찾아,  $field_name => field object 가 있는 곳에 조합배열(associated array)로 반환하는 매우 간단한 함수이다.
  • get_field() :
    특정 필드의 값을 반환한다.
    이것은 매우 다목적의 함수이다. 값을 저장하고, 값을 불어오고(echo), 이 값을 가지고 상호작용(interact )한다.
    반환되는 변수의 type은 필드 type과 관계가 있다는 것에 주의한다. 예를들면, repeater는 다차원 배열(multidimensional array)로 반환한다.
  • get_fields() :
    특정 페이지 / 글의 사용자정의 필드 값의 배열을 반환한다.
    이것은 모든 사용자정의 필드 값(“-“을 사용하지 않는다)을 찾아, $field_name => $value가 있는 곳에 조합배열(associated array)로 반환하는 매우 간단한 함수이다.
    템플릿에 보여줄 필드를 모르는 경우또는 개별적으로 코딩할 수 없을 만큼 많은 필드가 있을 경우에 사용해야 한다.
  • the_field()
    특정 필드 값을 표시한다. (이것은 “echo get_field($field_name)”와 같다)
  • update_field()
    이 함수는 필드 값을 업데이트하기 위해 사용한다.
  • LOOP
  • get_row_layout()
    이 함수는 the_flexible_field() 루프 안에서 현재 layout (string)을 반환한다. flexible content field는, 페이지에 임의의 순서로 배치하는, 많은 다른 layout 옵션을 가지고 있다.
  • get_sub_field_object()
    이 함수는 sub field 개체(has_sub_field 루프 안에서)를 반환한다.
  • get_sub_field()
    이 함수는 sub field 값을 반환하기 위해  repeater field 및 flexible content field (라이센스 키가 필요하다)와 함께 사용된다. 이 필드 중 하나를 루프 처리할 때, 이 함수는 현재 row에서 sub field를 반환한다.
  • has_sub_field()
    이 함수는 v3.3.4에서 추가되었고,  “the_repeater_field”와 “the_flexible_field” 둘 다를 대체한 것이다.
    이 함수는,  repeater field / flexible content 필드의 각각의 row를 루프 처리하기 위해, “while loop”에 사용되고, 이 함수와 함께 사용하기 위해 instant화(instantiate) 한다.
  • have_rows()
    이 함수는 필드(repeater 또는 flexible content)가 루프 처리할 데이터의 row를 가지고 있는지를 확인하는 함수이다. 이것은 TRUE 또는 FALSE를 반환하는 부울(boolean )함수이다.
    이 함수는 has_sub_fields 함수를 대신하지만, 작지만 중요한 차이가 있다.  큰 차이점은 스스로 rows를 루프 처리하지 않고, the_row 함수를 사용해야만 rows를 루프 처리한다.
    have_rows와 the_rows를 함께 사용하는 것은 have_posts와 the_posts ‘WP loop’ 아이디어와 비슷한 느낌을 가지도록 만들었다.
  • the_sub_field()
    이 함수는sub field 값을 표시하기 위해 repeater field 및 flexible content field (라이센스 키 필요)와 함께 사용된다. 이 필드 중 하나를 루프처리할 때, 이 함수는 현재 row에서 하나의 sub field를 표시한다.
  • update_sub_field()
    이 함수는 기존의 sub field 값을 업데이트하기 위해 사용된다. have_rows() 루프 안에서 사용한다면, 현재의 row가  sub field 값을 업데이트 하기 위해 사용된다. have_rows() 루프 밖에서 사용한다면, rows와 parents가 정확한 값을 처리할 장소로 지정된다.

답글 남기기