ACF: Начало

Приветствуем! На нашем сайте будет опубликован перевод официальной документации ACF для расширения аудитории этого чудесного плагина. Перевод статей не дословный, скриншоты будут взяты из официальной документации и публикуется это с разрешения автора плагина Элиота Кондона.

Advanced Custom Field – это прагин к WordPress, который позволяет добавлять произвольные поля к страницам редактирования контента WordPress. Эти поля называют “Произвольные поля”, они помогают сделать ваш сайт проще для наполнения.

Из этой статьи вы узнаете как:

  • Установить плагин
  • Создавать поля
  • Создавать контент
  • Показывать поля в теме

Введение

Произвольные поля “родная” часть WordPress и появляется на страницах, записях, произвольных типах записей и подобном, но обычный интерфейс не очень удобен. Когда ACF установлен вы можете выбирать какие боксы и поля показать, а какие – нет. Пример использования полей – задать дополнительную миниатюру для страницы.

Ниже изображена разница между стандартными и ACF полями.

Установка

Advanced Custom Fields плагин не является частью WordPress и не установлен изначально, поэтому его нужно устанавливать каждый раз как обычный плагин. Его можно найти как в “магазине” плагинов в админке, так и установить вручную.

Создание полей

Создание нового поля очень простой процесс, в котором нужно только кликать мышкой и вводить название переменных, никакого кода. Вы можете создать столько полей, сколько нужно (пр. переводчика: Это число на практике ограничено около 100 полей при стандартных настройках php.ini. Так же может не хватить оперативной памяти когда поля заполнены – следует помнить что при разработке нужно ограничивать тестовый сервер 128М оперативки и 1000 переменных, чтобы не пришлось платить дороже за хостинг)

Так же можно группировать поля так, как вам нужно, использовать вкладки.

Каждое поле имеет свои настройки, которые указывают как выгядит поле, какие значения возвращает и какую информацию хранит.

Создание контента

Когда поля созданы, можно начать их редактировать. Поля будут отображены на странице, когда совпадут все условия для вывода. Пример: когда выбрана соответствующая категория у записи. Останется их заполнить и сохранить страницу.

Отображение полей

Отображение полей сделано максимально просто. Любое значение может быть выведено как html, или записано в php переменную с помощью магических функций get_field() и the_field(). Эти функции (помимо многих других) позволяет разработчикам легко изменять темы для WordPress без проведения часов за чтением документации.

Вот пример кода, как данный API работает:

<h1><?php the_title(); ?></h1>
 
<?php if( get_field('sub_heading') ): ?>
    <h2><?php the_field('sub_heading'); ?></h2>
<?php endif; ?>
 
<div class="hero">
    <?php $image = get_field('hero_image'); ?>
    <img src="<?php echo $image['url']; ?>" alt="<?php echo $image['alt']; ?>" />
</div>
 
<?php if( have_rows('event') ): ?>
    <ul>
    <?php while( have_rows('event') ): the_row(); ?>
        <li>
            <a href="<?php the_sub_field('url'); ?>"><?php the_sub_field('title'); ?></a>
        </li>
    <?php endwhile; ?>
    </ul>
<?php endif; ?>

Обучение и поддержка

Данная статья охватывает все, что нужно для быстрого старта работы с ACF, но это только вершина айсберга всех возможностей. Кроме стандартного функционала так же доступна PRO версия, которая поможет настраивать еще гибче, превратив WordPress из CMS для информационных сайтов в совершенно любой сайт.

Так же на сайте плагина есть полная документация на английском языке и возможность связаться с создателем плагина напрямую (и он действительно отвечает на вопросы, но не стоит писать о том, что есть в документации =))

Ссылка на оригинал

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *