=== Chaplin ===
Contributors: Anlino
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=anders%40andersnoren%2ese&lc=US&item_name=Free%20WordPress%20Themes%20from%20Anders%20Noren¤cy_code=USD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHosted
Requires at least: 4.5
Requires PHP: 5.4
Tested up to: 5.0
Stable tag: trunk
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
== Installation ==
1. Upload the theme
2. Activate the theme
== How to Recreate the Screenshot ==
1. The screenshot of Chaplin (the one displayed on WordPress.org and in Themes → Add New) uses the Cover Page Template together with a couple of blocks in the WordPress Block Editor.
2. Go to Pages → Add New.
3. Enter a title of the page. In the righthand sidebar, expand the "Page Attributes" dropdown, click the "Template" dropdown and select "Cover Template" in the list.
4. Expand the "Excerpt" dropdown in the sidebar, and enter a subtitle/intro paragraph in the textarea.
5. Expand the "Featured Image" dropdown in the sidebar, click "Set featured image", and select which image to use.
6. Next, click the "Plus" symbol in the content and select the block "Columns" from the list. In the sidebar block settings, change "Columns: 2" to "Columns: 3". Add an image, a title, and a paragraph of text to each column in the "Columns" block, and you've recreated the structure of the screenshot in Chaplin.
== How to Use the Cover Template ==
1. Go to Pages → Add New, or Posts → Add New. The cover template can be used on both posts and pages.
2. In the righthand sidebar, expand the "Page Attributes" dropdown, click the "Template" dropdown, and select "Cover Template" from the list.
3. The cover template works best when you've added a featured image and an excerpt, which you can do in the righthand sidebar.
4. Click the gray "Preview" button to preview your page, or the blue "Publish" button to make it public.
5. The cover template includes a number of different settings that you can use to modify how your page is presented. Go to Appearance → Customize, and the click the "Cover Template" panel.
6. Here, you can modify the color of the image overlay, the color of the text in the overlay, whether to use a fixed background image (creating a parallax-esque effect), how the color overlay should blend into the image, and which opacity the color overlay should have.
7. When you're done, click the blue "Publish" button to save your changes.
== Change Colors ==
1. Log in to the administration panel of your site.
2. Go to Appearance → Customize.
3. Click the "Colors" panel.
4. Select the colors you want to use, and click the blue "Publish" button to save your changes.
== Change Fonts ==
1. Log in to the administration panel of your site.
2. Go to Appearance → Customize.
3. Click the "Fonts" panel.
4. Open fonts.google.com in a different browser window, and find the fonts you want to use. You can select one font for headings, and one for body text (everything but titles). Your body font should have at least the following styles: Regular, Regular Italic, Bold, and Bold Italic.
5. Go back to the "Fonts" window in your browser, and enter the names of the fonts you want to use in the "Body Font" and "Headings Font" text fields.
6. Select the weight of the headings in the dropdown. Note that all fonts do not have support for all font weights, so check which weights/styles the font you want to use supports.
7. Select which language packs you want to include in the list below "Languages". Again, check Google Fonts to make sure that your fonts supports the language packs you want to use.
8. Click the blue "Publish" button to save your changes.
== Set Sticky Header ==
1. Log in to the administration panel of your site.
2. Go to Appearance → Customize.
3. Click the "Site Header" panel.
4. Check the "Sticky Header" checkbox, and click the blue "Publish" button to save your changes.
== Disable Search Button ==
1. Log in to the administration panel of your site.
2. Go to Appearance → Customize.
3. Click the "Site Header" panel.
4. Check the "Disable Search Button" checkbox, and click the blue "Publish" button to save your changes.
== Replace the Menu Modal With a Regular Menu ==
1. Log in to the administration panel of your site.
2. Go to Appearance → Customize.
3. Click the "Site Header" panel.
4. Check the "Disable Menu Modal on Desktop" checkbox, and click the blue "Publish" button to save your changes.
== Change Pagination Type ==
1. Log in to the administration panel of your site.
2. Go to Appearance → Customize.
3. Click the "Posts" panel, and then the "Post Archive" panel.
4. There are three options for the pagination:
a. "Load more on button click": Displays a button that, when clicked, loads more posts without a hard reload.
b. "Load more on scroll": When the visitor has reached the bottom of the page, more posts are loaded without a hard reload.
c. "Previoius and next page links": Displays links that, when clicked, takes the visitor to then next or previous archive page with a hard reload.
5. Select the type you want to use, and click the blue "Publish" button to save your changes.
== Hide Related Posts ==
1. Log in to the administration panel of your site.
2. Go to Appearance → Customize.
3. Click the "Posts" panel, and then the "Single Post" panel.
4. Uncheck the "Show Related Posts" checkbox, and click the blue "Publish" button to save your changes.
== Show Excerpts In Previews ==
1. Log in to the administration panel of your site.
2. Go to Appearance → Customize.
3. Click the "Posts" panel, and then the "Post Archive" panel.
4. Check the "Show Excerpts" checkbox, and click the blue "Publish" button to save your changes.
== Change the Number of Columns in the Post Archive ==
1. Log in to the administration panel of your site.
2. Go to Appearance → Customize.
3. Click the "Posts" panel, and then the "Post Archive" panel.
4. Locate the "Number of Columns" setting in the list, and select the number of columns you want displayed.
5. Click the blue "Publish" button to save your changes.
== Adjust Image Aspect Ratio On Archive Pages
1. Log in to the administration panel of your site.
2. Go to Appearance → Customize.
3. Click the "Posts" panel, and then the "Post Archive" panel.
4. Locate the "Preview Image Aspect Ratio" setting in the list, and select the aspect ratio you want to use.
5. Click the blue "Publish" button to save your changes.
== Select Which Post Meta to Display ==
1. Log in to the administration panel of your site.
2. Go to Appearance → Customize.
3. Click the "Posts" panel. If you want to modify the post meta on single posts, click "Single Post". If you want to modify the post meta on the post archive, click "Post Archive".
4. There are three different post meta locations that you can modify:
a. "Top Post Meta": Displayed above the content, and below the titles, when viewing a single post.
b. "Bottom Post Meta": Displayed below the content, and above the comments, when viewing a single post.
c. "Archive Post Meta": Displayed below the title of post previews on archive pages.
5. Select the post meta you want to display in each locations, and click the blue "Publish" button to save your changes.
== Licenses ==
Merriweather font
License: SIL Open Font License, 1.1, https://opensource.org/licenses/OFL-1.1
Source: https://fonts.google.com/specimen/Merriweather
FontAwesome Icons
License: SIL Open Font License, 1.1, https://opensource.org/licenses/OFL-1.1
Source: https://www.fontawesome.io
FontAwesome Code
License: MIT License, https://opensource.org/licenses/MIT
Source: https://www.fontawesome.io
Feather Icons
License: MIT License, https://opensource.org/licenses/MIT
Source: https://feathericons.com
Illustration in screenshot.png by Anders Norén
License: Public Domain
Icons in screenshot.png by Feather Icons
== Changelog ==
Version 1.1.8 (2019-07-18)
-------------------------
- Better display of `is-style-outline` buttons in the block editor
- Added social icons for RSS and for Meetup.com
Version 1.1.7 (2019-07-17)
-------------------------
- Fixed the width of images in galleries sometimes not applying correctly (thanks, @mattmedeiros!)
- Fixed the block editor color classes for button text and button background not existing ¯\_(ツ)_/¯ (again, thanks @mattmedeiros!)
- Fixed some notices on the Error 404 page (stemming from the `body_class` function)
Version 1.1.6 (2019-07-17)
-------------------------
- Fixed the wrong color sometimes being applied to `.site-title` when displayed on cover-header and accent color is set
Version 1.1.5 (2019-07-15)
-------------------------
- Fixed the header toggles being hidden entirely when the search modal is disabled
Version 1.1.4 (2019-07-14)
-------------------------
- We weren't using the is-scrolling classes for anything, so remove the JS function adding them
- Added body classes to posts with/without single pagination and comments
- Better display of posts with single pagination, without comments and with related posts
- Adjusted font size of preview titles
- Added `post_password_required()` check to comments output
- Fixed conditional for output of comments in the post meta
- Don't output comments post meta if the post is password protected
- Don't show the post thumbnail on password protected posts
- Added aspect ratio setting for preview images, with instructions in readme
Version 1.1.3 (2019-07-14)
-------------------------
- Reduced margin between items in the preview post meta
- Only output headings spacing if a value is set
- Added dropcap styling to front-end styles
- Changed enqueues to use dashes instead of underscores, to be more consistent with core
- Moved FontAwesome to its own CSS file, so it can be selectively dequeued/enqueued when needed
- Moved the output of the Customizer front-end style to `chaplin_register_styles()`, for clarity
- Better default handling of the `.overlay-header .header-inner` color, when custom colors aren't set
- Made it possible to display both the search toggle and the "regular menu" (non-modal) at the same time
- Adjusted right margin of the top arrow on the sub menu
Version 1.1.2 (2019-07-13)
-------------------------
- Added filter option for whether to show or hide footer and header on only-content templates
- Fixed a bad bug with the main menu collapsing when a sub menu is toggled (thanks, @acalfieri!)
- Fixed a bad bug with the main-menu-alt items being hit by the toggles in the menu modal (again, thanks @acalfieri!)
Version 1.1.1 (2019-07-13)
-------------------------
- Various a11y improvements:
- Better heading hierarchy
- Added dynamic aria-expanded and aria-pressed attributes to the toggles and modals
- Added a focus loop to the menu modal and search modal
- Added skip link
- Hide cover modals entirely when they're inactive, preventing focus traps
- Fixed wp_kses removing focusable and tabindex output from SVGs
Version 1.1.0 (2019-07-12)
-------------------------
- Added color scheme functionality, starting with 10 color schemes
- Fixed some issues with overlay colors and the sticky menu
- Fixed issue with Classic Editor styles when a serif font is set
- Added template-full-width-cover.php
- Added color settings for button background and button text color
- Fixed P3 color issue with some elements
- Updated theme description
Version 1.0.18 (2019-07-10)
-------------------------
- Fixed full width page template
Version 1.0.17 (2019-07-09)
-------------------------
- Set the site title and description to use partial refresh in the Customizer
- Added the Full Width Template, and restructured the CSS chapter numbers to easily allow for more templates
- Updated the Only Content Template to work with posts as well
- Updated the Only Content Template to not output the header and footer markup – might add a post meta checkbox for this later on
- Added the Full Width and Only Content Template (that's a mouthful), which combines the Full Width Template and Only Content Template
- Filtered the `body_class` on these page templates to add shared classes and simplify styling
Version 1.0.16 (2019-07-09)
-------------------------
- Test solution for centered aligned embed content
- Updated block editor styles to better reflect how paragraphs in alignfull groups are displayed
- Added wide entry-content for `.woocommerce-page` pages
- Added styling for Select2 element, and added targeting of its border-color to the Customizer CSS output
- For product pages, set the comments title to "Reviews" instead of "Comments", and make the list of CPTs checked for this filterable
- Adjusted readme.txt
Version 1.0.15 (2019-07-09)
-------------------------
- Added base margin to wp-block-image and wp-block-embed (without alignment classes)
Version 1.0.14 (2019-07-08)
-------------------------
- Adjusted handling of centered paragraphs inside group blocks that are either alignwide or alignfull
Version 1.0.13 (2019-07-08)
-------------------------
- Customizer: Changed Posts into a "Posts" panel with two sections, "Single Post" and "Post Archive", and restructured the code accordingly
- Added a "Post Grid Columns" setting, which can be used to change the number of columns used on archive pages
- Added documentation in the readme for the "Number of Columns" settings
- Moved the "Pagination Type" setting into "Posts → Post Archive", and updated the documentation accordingly
- Moved up the "Cover Template" panel in the Customizer panel list
- Adjusted the theme description slightly
Version 1.0.12 (2019-07-07)
-------------------------
- Fixed wp-block-gallery targeting to prevent issues with alignwide/alignfull
- Removed default margin for