=== Ephemeris ===
Contributors: ahortin
Tags: one-column, two-columns, left-sidebar, right-sidebar, flexible-header, custom-background, custom-header, custom-logo, custom-menu, editor-style, featured-image-header, featured-images, footer-widgets, full-width-template, microformats, post-formats, sticky-post, theme-options, threaded-comments, translation-ready, blog, e-commerce, rtl-language-support
Requires at least: 4.8
Tested up to: 5.0.1
Stable tag: 1.4.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

The Ephemeris theme is a clean, fast and simple platform for creating beautiful, responsive custom WordPress themes. It's a simple starter theme built on HTML5 & CSS3. At its core is a fluid, responsive grid based on percentages, making for a flexible layout. It incorporates a set of common templates, support for WordPress Post Formats and the gorgeous, retina friendly Font Awesome icon font. Ephemeris is a true multi-purpose theme. With its extensive use of hooks, developers will find it a breeze to customise and extend. Ephemeris is WooCommerce and bbPress compatible, Multilingual Ready (WPML), translatable, and provides RTL language support. It's also compatible with a wide range of popular page builders such as Elementor, Divi Builder, Beaver Builder, SiteOrigin Page Builder and Visual Composer. On top of that, if Elementor is your Page Builder of choice, then you also get the ability to use your own custom header and footer templates that you've created with Elementor, rather than the default theme header and footer, if you so choose. Ephemeris also supports the new WordPress Block Editor (Gutenberg). Now that's pretty cool, eh!


== Description ==

The Ephemeris theme is a clean, fast and simple platform for creating beautiful, responsive custom WordPress themes. It's a simple and elegant starter theme built on HTML5 & CSS3. At its core is a fluid, responsive grid based on percentages. This means not only is it flexible, it's extremely easy to customise.

If you do decide to use a child theme with Ephemeris, there's no need to use CSS @import or even enqueue the parent stylesheet. Ephemeris will automatically enqueue the parent stylesheet for you. Cool eh!

Ephemeris uses [Normalize](https://github.com/necolas/normalize.css) to make sure that browsers render all elements more consistently along with some default stylings from HTML5 Boilerplate. It also incorporates the gorgeous [Font Awesome](http://fortawesome.github.io/Font-Awesome/) icon font by Dave Gandy.

If you're looking to build an eCommerce website, Ephemeris supports the excellent WooCommerce plugin, straight out of the box.

Templates

Ephemeris includes a set of your most common theme templates, including templates for Full-Width pages, Left Sidebar, Right Sidebar (default), Front-Page, Tag, Categories, Authors, Search, Posts Archive and 404. Templates like the Full-Width, Left Sidebar and Right Sidebar template will work on both Pages and Posts, for maximum flexibility.

If you're using one of the many page builder plugins that are available, such as Elementor, Divi Builder, Beaver Builder, SiteOrigin Page Builder or Visual Composer, try using the Page Builder Full-Width Template. The Page Builder Full-Width Template is a true full browser width template. If you want a completely blank full-width page with no header or footer sections, such as for a landing page, then there is also a Page Builder Blank Template.

On top of that, if Elementor is your Page Builder of choice, then you also get the ability to use your own custom header and footer templates that you've created with Elementor, rather than the default theme header and footer, if you so choose. Now that's pretty cool, eh!

Ephemeris also supports the new WordPress Block Editor (Gutenberg). Along with support for all the standard Gutenberg Blocks, full-width pages support the 'Wide Width' and 'Full Width' controls that are available on certain blocks.

For maximum flexibility, you can specify the layout for the Default Template. The Default Template will show a right-hand sidebar by default. Using the Site Layout > Template Defaults option in the Customizer you can change the Default Template to be Full-Width or show a left-hand sidebar instead. The Default Template can be modified for Pages, Posts and the Post Archive (i.e. Blog).

Post Formats

All the standard WordPress Post Formats are supported. These include; Aside, Gallery, Link, Image, Quote, Status, Video, Audio, Chat and of course, your standard post.

Widgets

Widgets are a great way of adding extra content to your site and Ephemeris has a whole assortment of them.

Main Sidebar: Appears in the sidebar on posts and pages
Blog Sidebar: Appears in the sidebar on the blog and archive pages only
Single Post Sidebar: Appears in the sidebar on single posts only
Page Sidebar: Appears in the sidebar on pages only
WooCommerce Sidebar: Appears in the sidebar on WooCommerce pages only
bbPress Sidebar: Appears in the sidebar on bbPress pages only

The Footer Widget areas are dynamic! You can use up to four of these and they'll magically space themselves out evenly. For example, if you only add widgets into the First Footer Widget Area, then it will expand the full width of the page. However, if you add widgets to all four Footer Widget Areas, they'll magically space themselves out over four equal columns.
Footer Widget 1: Appears in the footer in column 1
Footer Widget 2: Appears in the footer in column 2
Footer Widget 3: Appears in the footer in column 3
Footer Widget 4: Appears in the footer in column 4

Menus

Ephemeris supports all your standard WordPress menus. On top of that, it's super easy to create a simple mega menu by just adding the 'mega-menu' class (without the quotes) to your top-level menu item where you want the mega menu to appear. You can also use the 'menu-header' class to add a slighty stylised header into your menu and the 'menu-divider' class to add a horizontal divider line between your menu items.

Custom Logo

The site logo can be easily changed using the site logo feature. You change this in Appearance > Customize > Site identity

Custom Header

The page header can be easily changed using the Custom Header feature. You change this in Appearance > Customize > Header Image

Custom Background

The background pattern can be changed using the Custom Background feature. You change this in Appearance > Customize > Background Image

Multilingual Ready (WPML)

Using the WordPress Multilingual Plugin (WPML) it's now easy to build multilingual sites. With WPML you can translate pages, posts, custom types, taxonomy, menus and even the theme's texts.

WooCommerce Support

WooCommerce is a WordPress eCommerce toolkit that helps you sell anything. Beautifully. Turn your website into a powerful eCommerce site by installing the WooCommerce plugin by WooThemes.

Developers

If you're a developer, you'll love the extensive use of hooks, making Ephemeris a breeze to customise and extend. To make this even easier, you can even view a handy visual map of all the hooks simply by defining WP_EPHEMERIS_HOOKS as true in your wp-config.php file. Doing this will cause Ephemeris to display all the theme hooks so that it's easier to work out where they are all located.

== Installation ==

There are three ways to install your theme. It can be installed by manually uploading the files to the themes folder using an FTP application, it can be installed by downloading from the WordPress Theme Directory within the Dashboard or it can be installed by uploading the theme zip file that you downloaded.

Use the following instructions to install & activate Ephemeris using your preferred method.

Manual installation:

1. Unzip the files from the Ephemeris zip file that you downloaded
2. Upload the Ephemeris folder to your /wp-content/themes/ directory
3. Click on the Appearance > Themes menu option in the WordPress Dashboard
4. Click the Activate link below the Ephemeris preview thumbnail

Install from the WordPress Theme Directory:

1. Click on the Appearance > Themes menu option in the WordPress Dashboard
2. Click the Install Themes tab at the top of the page
3. Type 'ephemeris' in the search field, without the quotes, and then click the Search button
4. Click the Install Now link below the Ephemeris preview thumbnail
5. Once the theme has been installed, click the Activate link

Install by uploading the theme zip file:

1. Click on the Appearance > Themes menu option in the WordPress Dashboard
2. Click the Install Themes tab at the top of the page
3. Click on the Upload link just below the two tabs at the top of the page
4. Click the Browse button, browse to the folder that contains the theme zip file, select it and then click the Open button
5. Click the Install Now button
6. Once the theme has been installed, click the Activate link


== Getting Started ==

Since Ephemeris is a starter theme to kick off your own awesome theme, the first thing you want to do is copy the Ephemeris theme folder
and change the name to something else. You'll then need to do a three-step find and replace on the name in all the templates.

1. Search for Ephemeris inside single quotations to capture the text domain.
2. Search for ephemeris_ to capture all the function names.
3. Search for Ephemeris with a space before it to replace all the occurrences of it in comments.
   (You'd replace this with the capitalized version of your theme name.)

or, to put it another way...

Search for:'ephemeris'
 Replace with:'yourawesomethemename'
Search for:ephemeris_
 Replace with:yourawesomethemename_
Search for: Ephemeris
 Replace with: YourAwesomeThemeName

Lastly, update the stylesheet header in style.css and either update or delete this readme.txt file.


== License ==

Ephemeris WordPress Theme, Copyright 2018 Anthony Hortin
Ephemeris is distributed under the terms of the GNU GPL

[GNU General Public License version 2](https://www.gnu.org/licenses/gpl-2.0.html)

== Credits ==

Ephemeris includes the following awesomeness:

[Unsemantic](http://unsemantic.com), which is licensed under GPL and MIT license
[Normalize.css](https://github.com/necolas/normalize.css), which is licensed under the MIT license
[jQuery Validation](https://jqueryvalidation.org) which is dual licensed under the MIT license and GPL licenses
[Font Awesome](https://fontawesome.com) icon font, which is licensed under SIL Open Font License and MIT License

and also uses the following:

[Open Sans font](https://fonts.google.com/specimen/Open+Sans), which is licensed under Apache License Version 2.0
[Dosis](https://fonts.google.com/specimen/Dosis), which is licensed under SIL Open Font License 1.1

Screenshot images are all licensed under CC0 1.0 Universal - https://creativecommons.org/publicdomain/zero/1.0/deed.en
https://pixabay.com/en/lighthouse-glow-evening-clouds-2372461/
https://pixabay.com/en/action-balancing-boy-extreme-fun-1853289/
https://pixabay.com/en/stockholm-sweden-city-urban-1970608/
https://pixabay.com/en/beautiful-blond-blonde-field-1869583/


== Changelog ==

= 1.4.3 =
- Update Video Embed styles for the Block Editor (Gutenberg) to allow for different aspect ratios

= 1.4.2 =
- Update Blockquote and Pull Quote styles for the Block Editor (Gutenberg) to make them more consistent between the editor and the front-end
- Update default gradient background for image/gallery captions in the Block Editor (Gutenberg) and replace with simple white opaque background
- Update the Block Editor (Gutenberg) control styles to make them look consistent with the rest of the WordPress Dashboard
- Update body class for Block Editor (Gutenberg) dashboard editor styles
- Update how Block Editor (Gutenberg) styles are injected into head when in the dashboard editor
- Update Block Editor (Gutenberg) Font Style definitions and styles
- Update Normalize to v8.0.1
- Update Font Awesome to v5.5.0
- Fix alignwide and alignfull block widths. Widths needs to be adjusted based on the containing grid rather than template due to new functionality in v1.4 allowing selection of default template layouts

= 1.4.1 =
- Update description in default stylesheet
- Update default Block Editor (Gutenberg) styles to make Custom Meta Boxes more visible
- Update Block Inserter styles in the Block Editor (Gutenberg) as it now uses flexbox. On larger screen sizes the Block Inserter will be wider, contain more blocks per row and increase the icon size to improve visibility
- Fix issue with attachment page sidebar not displaying properly
- Add new template (forum.php) for bbPress pages. This template will display a right-hand sidebar
- Add new bbPress sidebar. This sidebar will appear on bbPress forum pages if it contains widgets, otherwsise the standard sidebar (Main Sidebar) will appear. The bbPress sidebar is only available if the bbPress plugin is activated

= 1.4 =
- Fix mobile menu from displaying in background on really short pages, while page is loading
- Updated Customizer Custom Controls
- Add front-end styles for the new Block Editor (Gutenberg) compatibility. As the Block Editor is still under development, be aware these styles will most likely change as the Block Editor changes
- Add Dashboard editor styles for the new Block Editor (Gutenberg) compatibility. As the Block Editor is still under development, be aware these styles will most likely change as the Block Editor changes
- Add ability to select the default template layout for Pages, Posts and Posts Archive (i.e. Blog). You can select from Left Sidebar, Right Sidebar or No Sidebar. If you decide to change this option from the default settings you may want to consider regenerating your thumbnails for any existing images you've uploaded to ensure they display correctly
- Add new Home and Right Sidebar templates to help with setting the default template layouts
- Add ability to select templates on Posts
- Add filters to make it easier to change the comment form validation error messages

= 1.3.5 =
- Update styles for cookie consent on comment form
- Add assistive text containing link title to social media icons

= 1.3.4 =
- Move the WooCommerce Layout Customizer section to the WooCommerce panel if WC >=v3.3
- Add styles creating simple mega menus
- Update styles for menu headers and menu dividers

= 1.3.3 =
- Removed Modernizr script as it's better to load it only when you actually want to make use of it
- Update Font Awesome to version 5.0.8
- Update table styles to remove bottom border
- Update blockquote style to add more padding above and below

= 1.3.2 =
- Update WooCommerce add_theme_support option to include default number of rows and columns
- Update WooCommerce Customizer options to only show the Control for selecting the number of products if WooCommerce is less than v3.3
- Update usage of loop_shop_per_page filter so it's only used if WooCommerce is less than v3.3

= 1.3.1 =
- Update theme url's to https
- Update URL for GNU GPL 2.0 License
- Fix minor spelling mistakes

= 1.3 =
- Fix search form placeholder attribute to ensure value is escaped
- Fix customizer options when outputting to head to ensure values are escaped

= 1.2 =
- Fix handles on scripts & styles
- Fix all strings that weren't translated
- Fix short array syntax for use with php <5.4
- Fix usage of php array_column() for use with php <5.4
- Fix usage of anonymous functions in Customizer callbacks as they're not available in php 5.2
- Update Readme
- Update Screenshot image
- Update excerpt_more filter to make sure it doesn't affect admin
- Removed new contact methods. Plugin Territory
- Removed search-form from add_theme_support as I customise it
- Removed @import from editor-style.css
- Removed usage of get_home_url() and replaced with home_url()
- Add unique prefixes where required
- Add translation functions to strings where missing
- Add unminified versions of scripts & styles to theme
- Add missing singular placeholder to comments template
- Add copyright message to Readme
- Add get_template_directory() when loading non template PHP files
- Add search query to input value on search form
- Add license details for images used in screenshot

= 1.1 =
- Fix weird borders on customizer color controls.
- Fix alignment of input on default customizer color control
- Fix position of label and alpha colour customizer control input field
- Fix height of customizer input fields so they're the same height as select fields
- Add new Date Time Customizer control sanitization function

= 1.0 =
- Initial version
