front page php wordpress
Иерархия шаблонов
Содержание
Редактировали какие-нибудь готовые темы для WordPress? Наверное заметили, что в каждой своя структура файлов.
Это потому, что существует порядок, следуя которому WordPress, в зависимости от текущей страницы сайта, ищет соответствующие файлы в директории темы и, если они существуют — подключает.
Этот урок должен раз и навсегда ответить на вопрос — какой из PHP-файлов темы используется для отображения той или иной страницы сайта?
Что в видеоуроке?
В этом уроке мы с вами приступим к натяжке других шаблонов вёрстки на нашу тему WordPress.
Чтобы скачать тему WordPress, которая получилась у нас в процессе этого урока, необходимо приобрести курс.
Страница поста блога:
Страница 404-й ошибки:
Страница категорий (рубрики на блоге)
«Статическая» страница блога:
Типо тоже обычная страница, но не совсем – потому что содержит форму:
Условные теги WordPress
К примеру, функция is_single() позволяет определить, находимся ли мы, просматривая сайт в данный момент, на странице поста.
Полный список условных тегов WordPress и их документацию вы найдёте здесь.
На некоторых схемах ниже, для того, чтобы обозначить, для какого типа страницы используются определенные файлы, я как раз таки задействовал условные теги.
Структура файлов (схема подключения)
Кликните по картинке, чтобы открыть в полном размере.
На графике показан порядок, по которому WordPress запрашивает файлы. Есть и альтернативные варианты этой схемы, чуть более старые или урезанные, но рабочие, вот первый, а вот второй.
$custom Название файла шаблона страниц — про них всё подробно расписано здесь.
Пример для рубрик
Сразу же приведу пример для страницы с рубрикой с >54 и ярлыком myphotos :
Создание темы WordPress — home.php, front-page.php, and index.php
Сегодня поговорим о трех очень важных файлах: home.php, front-page.php и index.php. Я объединяю эти три файла в одной статье, потому что только ваш выбор определит какой из этих файлов будет вашей “главной или домашней страницей”. Подумайте об этом с точки зрения обычных, статических html-сайтов. Обычно мы помещаем все в index.php и ваш браузер знает, что этот файл нужно искать. В WordPress все немного отличается. Существует некая иерархия шаблонов и файлов. То есть, чем конкретнее вы назовете файл, тем WordPress проще понять, что вы от него хотите. Пока не совсем понятно, так что разберем поглубже.
Параметры WordPress
Если вы войдете в Панель управления WordPress и найдете вкладку «Настройки», вы увидите вкладку «чтение».
Здесь вы найдете несколько очень важных параметров. Прежде чем выбрать какие-либо варианты, подумайте о том, как был задуман ваш сайт. Будет ли домашняя страница длинной, статичной страницей с различными битами информации или она будет просто отображать статьи в блоге? Может быть, даже и то, и другое! В зависимости от ответа на этот вопрос, мы определим, что мы выбираем для отображения на странице опции чтения.
home.php
Если ваш сайт будет блогом, вам следует остановиться на опции по умолчанию » Ваши последние записи «.
home.php — это файл, который WordPress ищет первым, когда вы выбираете эту опцию. Поэтому код, который идет в home.php будет вашим кодом «домашней страницы», который отображает ваши последние сообщения в блоге.
front-page.php
Предположим, веб-сайт, который вы создаете, предназначен для бизнеса, и заказчику нужен слайдер, за которым следуют три основные услуги, которые они предоставляют, а затем блок текста, сообщающий некоторую информацию “о компании” с боковой панелью, которая позволит отображать виджеты. В этом случае вы перейдете на страницу опции чтения и выберите опцию «статическая страница».
Затем вы должны назначить главную страницу, которую вы должны создать заранее (чтобы было из чего выбрать). Далее нужно выбрать на какой странице должны отображаться ваши сообщения в блоге. Если вы не планируете иметь блог вообще, вы можете оставить этот второй вариант пустым.
Теперь, когда вы выбрали статическую страницу, WordPress автоматически будет искать файл под названием front-page.php. Весь код для отображения каждой из областей, которые мы предположили выше, будет находиться внутри этого файла.
index.php
Для чего же тогда нужен index.php? WordPress использует этот файл для того, что называют резервным шаблоном по умолчанию. Это означает, что, если WordPress не может найти home.php или front-page.php, он будет искать index.php как последнюю инстанцию. Поэтому моя рекомендация и то, что я лично делаю, — это какой бы вариант я ни выбрала для своей домашней страницы, я возьму код из этого файла, скопирую и вставлю его в свой index.php. Потому что, если по какой-либо причине что-то случится с файлом моей главной страницы, у него всегда будет резервная копия.
Независимо от того, какой файл шаблона вы будете использовать, для кода страницы, на которой будут отображаться ваши последние сообщения в блоге, всегда будет использоваться home.php. Таким образом, если вы настроили статическую страницу в качестве главной целевой страницы, а затем решили разместить сообщения в блоге на странице под названием Блог, этот шаблон страницы будет home.php. То есть, вы используете и front-page.php и home.php в одном проекте, но front-page.php имеет код для отображения основного содержимого целевой страницы и home.php — код для отображения сообщений в блоге.
Пример
Давайте создадим пару новых записей через панель управления. И будем отображать на главной последние записи.
Теперь в корне нашей темы (на одном уровне index.php) создадим страницу home.php со следующим кодом (код можно посмотреть на gitHub):
Давайте разберем его по частям.
Главная часть любой страницы с контентом – это цикл, который по сути является функцией, которая динамически получает весь контент, отображаемых в записях и страницах. Базовая структура цикла выглядит так же, как и в приведенном выше коде, но ее можно расширить и использовать для передачи определенных спецификаций о том, какой тип данных вы хотите получить и как он будет отображаться. Мы не будем вдаваться в это подробно в этой статье, возможно, я напишу о цикле позже.
Цикл написан так: if (have_posts()) – он проверяет, есть ли у вас записи, а затем говорит, пока у вас есть запсиси while (have_posts()) – покажите их the_post()!
Оператор if начинается с if, затем дает вам состояние else (не всегда требуется), а затем заканчивается endif.
Оператор while начинается с while и заканчивается endwhile.
В случае цикла вы увидите, что мы начинаем с оператора if, затем идет оператор while, затем мы заканчиваем while с endwhile, затем приходит оператор else и, наконец, endif, чтобы остановить все.
Между оператором while и оператором endwhile мы хотим включить html для структурирования макета сообщений в блоге. В заявлении else всегда лучше предоставить простое предложение, которое говорит что-то вроде “Извините! Сообщений не найдено». Это лучшая практика на случай, если вы еще не добавили записи, и кто-то зайдет на страницу блога.
Внутри цикла есть несколько действительно важных функций, первая из которых-вызов миниатюры изображения записи. Вызывается эта функция the_post_thumbnail(). Хорошая практика перед вызовом миниатюры проверять, существует ли она вообще. Поэтому мы создаем другой оператор if, который использует функцию has_post_thumbnail (). Итак, мы спрашиваем WordPress, есть ли данное изображение? Если это так, покажите его, иначе не показывайте его вообще.
the_title(); — будет вызывать название записи в блоге.
Permalink
Постоянная ссылка — это ваш лучший друг! В приведенном выше коде вы увидите, что ссылка прикреплена к изображению и заголовку и помещена в тег src. Это связано с тем, что the_permalink() динамически создает ссылку на основной пост. Помните, что мы смотрим на список сообщений в блоге, которые не показывают весь текст и имеют кнопку read more. Поэтому, прикрепляя постоянную ссылку к src наших якорных тегов, WordPress делает всю работу для вас, чтобы связать страницу блога, которая содержит все содержимое этого одного сообщения.
Чтобы отобразить категории, прикрепленные к каждому сообщению в блоге, мы используем функцию the_category().
Таким же образом, как и категории, теги используют функцию the_tags ().
В коде мы видим еще три функции, которые не всегда необходимы, но их нужно знать.
Первая-это функция the_date (), которая вводит дату первоначального размещения сообщения в блоге. Мы передаем функцию get_option () в качестве параметра, чтобы захватить формат даты, который выбрали для использования в настройках панели мониторинга.
Затем у нас есть функция the_time (), которая работает также, но вызывает время публикации сообщения. Затем он передает функцию get_option (), чтобы вытащить формат времени, выбранный в настройках панели мониторинга.
И, наконец, у вас есть функция the_author_posts_link (), которая предоставляет вам имя человека, написавшего статью (если вы настроили его как пользователя, и он заполнил свой профиль) и ссылку на отдельную страницу автора.
Последние две функции, которые я хочу показать вам, являются важными!
Первая-the_excerpt (), которая вызывает первые несколько строк текста из записи блога в качестве тизера, чтобы заинтересовать кого-то щелкнуть по нему и прочитать полную статью.
Второй-the_content (), который я не использую в коде выше, но идет рука об руку с the_excerpt(). The_content() вызывает полную статью и будет использоваться в single.php — файле, который является файлом шаблона для отображения полной статьи записи.
Статическая страница
Если вы решили отображать на главной странице статический файл и используете шаблон front-page.php, то этот файл будет содержать только необходимую структуру html для отображения дизайна, который у вас уже есть. Поэтому нет никакого конкретного кода, который можно показать. Вы можете включить цикл здесь, вы можете использовать WP_Query для вызова пользовательских циклов, если это необходимо, или вы можете просто вставить статический html. Единственное, что я подчеркну — это обязательное включение функций get_header() и get_footer() в верхней и нижней части этой и каждой страницы.
Теперь вы можете создать главную страницу своего сайта по своему усмотрению. WordPress содержит гораздо больше функций и возможностей, с которыми вы моете познакомиться в кодексе. В следующей статье мы рассмотрим шаблон страницы — Page.php.
Для большинства пользователей WordPress — это черный ящик. Вы помещаете Read more
functions.php файл шаблона функций в WordPress действительно является двигателем вашей Read more
Сегодня мы поговорим о еще трех файлах, которые, если их Read more
Сегодня речь пойдет об архивах записей, а точнее о файлах Read more
Страницы » Настройка главной (начальной) страницы
Главная страница — это входная дверь вашего сайта. Выполнив действия, описанные в этом руководстве, вы можете сделать главной любую созданную вами страницу.
Шаг 1: Создание «главной» страницы
Если у вас уже имеется новая страница, которую предполагается использовать как главную, пропустите этот шаг и переходите к шагу 2.
Шаг 2: Настройка статической главной страницы
Чтобы установить новую страницу в качестве главной страницы сайта, выполните следующие действия.
Чтобы появилась эта опция, у сайта должна быть как минимум одна опубликованная страница.
В окне предварительной настройки новая выбранная страница будет отображаться как начальная страница вашего сайта.
Нажмите кнопку Сохранить изменения, чтобы сохранить настройки главной страницы.
Нужно быстро заменить страницу, которая назначена главной страницей сайта? Другой способ: перейдите в раздел меню Мой сайт → Страницы и нажмите значок с многоточием рядом со страницей. Затем выберите «Установить как главную страницу»
Шаг 3: Создание страницы «Блог» (необязательно)
Если вы планируете вести блог, можно настроить отдельную страницу, на которой будут отображаться все ваши записи в блоге.
Помните: чтобы страница появилась в раскрывающемся меню страницы «Записи», она должна быть опубликована.
Шаг 4. Создание меню
После того как страницы созданы, можно настроить меню навигации сайта. Нажмите эту кнопку, чтобы узнать, как это сделать
Дополнительные возможности настройки
Многие элементы статической страницы можно изменить с помощью пользовательских CSS. Расширенные возможности пользовательской настройки тем, в том числе CSS, доступны в тарифных планах не ниже WordPress.com Premium.
Шаблоны главной страницы и ваша тема
У разных тем могут быть разные макеты главной страницы. В зависимости от инструкций к теме вам может потребоваться изменить шаблон страницы или настроить области избранного содержимого.
Кроме того, в некоторых темах для главной страницы не предусмотрены области отображения виджетов на боковой панели. Вы можете быть уверены, что при переходе на одну из таких тем содержимое, созданное вами на боковой панели не пропадёт, — оно просто не будет отображаться на главной странице.
Лучший способ узнать, как изменить дизайн главной страницы темы — изучить инструкции в разделе «Информация» соответствующей темы в каталоге тем.
WordPress.org
Codex
Иерархия шаблонов
Contents
Введение
Страницы WordPress сайта собираются подобно пазлу из файлов-шаблонов. Некоторые шаблоны (например header.php и footer.php) задействованы на всех страницах, другие используются только при определенных условиях.
О чём эта статья
Эта статья отвечает на следующий вопрос:
Какие файлы шаблонов использует WordPress для отображения определённого типа страниц?
Кому это может пригодиться
Со времен появления тем оформления в WordPress версии 1.5, шаблоны становятся все более настраиваемы. Перед тем как создать свою тему, вам нужно понять механизм работы шаблонов: как WordPress отбирает файлы-шаблоны для вывода разных страниц в вашем блоге. Если вы хотите что-то изменить в готовой теме, эта статья поможет вам понять, какой шаблон нужно редактировать.
Использование тегов условий
WordPress может несколькими способами подбирать шаблоны в соответствии с типом контента. Разработчики Тем для WordPress могут также использовать теги условий (Conditional Tags) для того, чтобы определенный шаблон был использован на конкретной странице блога. Некоторые Темы могут не содержать всех файлов-шаблонов, описанных в этой статье. В некоторых Темах использованы теги условий (conditional tags) для вызова других шаблонов. Читайте подробнее здесь: теги условий (Conditional Tags) и «Query Based» in Theme Development.
Иерархия шаблонов
Общая идея
WordPress использует Строку Запроса — информацию, содержащуюся в каждой ссылке вашего сайта — для того, чтобы определить какой шаблон или набор шаблонов использовать для отображения страницы.
Сперва WordPress находит каждую Строку Запроса по типам запросов — т.е. определяет какой тип страницы (страница поиска, страница категорий, главная страница и др.) был запрошен.
После этого шаблоны выбираются и содержимое страницы генерируется в порядке, предложенном иерархией шаблонов WordPress, в зависимости от доступности шаблонов конкретной темы WordPress.
WordPress ищет файлы шаблонов со специальными именами в папке текущей темы и использует первый подходящий файл шаблона указанный в соответствующем запросе.
За исключением основного шаблона index.php, разработчики тем могут использовать или не использовать файлы шаблонов по желанию. Если WordPress не находит шаблон с указанным именем, он переходит к следущему по иерархии шаблону. Если не один из искомых шаблонов не подходит, WordPress использует index.php (шаблон главной страницы Темы).
Примеры
Если Ваш блог находится по адресу http://domain.com/wp/ и посетитель переходит на страницу рубрики http://domain.com/wp/category/your-cat/, WordPress в папке текущей Темы в первую очередь ищет шаблон, который отвечает за вывод этой рубрики. Если ID данной рубрики 4, WordPress ищет шаблон с именем category-4.php. Если такой шаблон не найден, WordPress ищет общий для всех рубрик шаблон category.php. Если и такого файла-шаблона нет, WordPress ищет шаблон для вывода архива archive.php. Если нет и этого файла, WordPress будет использовать основной шаблон Темы index.php.
Если посетитель переходит на главную страницу сайта http://domain.com/wp/, WordPress ищет шаблон home.php и использует его для генерации запрошенной страницы. Если файла home.php в папке Темы нет, WordPress использует файл index.php для вывода главной страницы блога.
Наглядный обзор
Следующая диаграмма показывает, какие файлы шаблона вызываются при создании страницы WordPress, согласно иерархии шаблонов WordPress.
Подробнее о иерархии шаблонов
Рассмотрим приоритет использования шаблонов при выводе разных типов контента в WordPress.
Отображение главной страницы
Отображение Главной страницы
Отображение одиночной записи
Отображение статической страницы
Отображение рубрики
Отображение метки
Отображение автора
Отображение даты
Отображение результатов поиска
Отображение ошибки 404 (Не найдено)
Отображение приложений
Смотрите также
Следующие ссылки имеют непосредственное отношение к теме статьи.
WordPress.org
Chapters
Topics
By default, WordPress shows your most recent posts in reverse chronological order on the front page of your site. Many WordPress users want a static front page or splash page as the front page instead. This “static front page” look is common for users desiring static or welcoming information on the front page of the site.
The look and feel of the front page of the site is based upon the choices of the user combined with the features and options of the WordPress Theme.
Template Hierarchy of Custom Front Page # Template Hierarchy of Custom Front Page
On the site front page, WordPress will always use the front-page.php template file, if it exists. If front-page.php does not exist, WordPress will determine which template file to use, depending on the user configuration of Settings > Reading >Front page displays, as follows:
Custom Site Front Page Template # Custom Site Front Page Template
To create a custom site front page template, include either of the following in the Theme:
Custom Blog Posts Index Page Template # Custom Blog Posts Index Page Template
To create a custom blog posts index template, include the following in the Theme:
Use only the home.php template file for the blog posts index. Do not use a Custom Page Template (such as template-blog.php) for two reasons:
Contextual Conditional Tags # Contextual Conditional Tags
is_front_page # is_front_page
is_home # is_home
Configuration of front-page.php # Configuration of front-page.php
Conditional display within front-page.php # Conditional display within front-page.php
Method 1: including custom content directly within front-page.php:
Method 2: including any page template:
Filtering frontpage_template # Filtering frontpage_template
Another way to allow the site front page to display either a static page/custom content or the blog posts index, without adding conditional code within front-page.php, is to filter frontpage_template, by adding a filter callback to functions.php:
This method causes WordPress to bypass the front-page.php template file altogether when the blog posts index is being displayed.
Adding custom query loops to front-page.php # Adding custom query loops to front-page.php
If the front-page.php template file includes a default WordPress Loop, like so:
To display custom loops (latest blog posts, custom/featured content, etc.), add secondary loop queries using calls to WP_Query. For example, to show the 3 latest blog posts:
Pagination # Pagination
Static front pages are not intended to be paged. None of the WordPress Previous / Next page link functions work with a static front page. Pagination on a static front page uses the page query variable, not the paged variable. See the WP_Query for details.