Skip to content

cogdog/wp-highlights

Repository files navigation

HTML5 Up Highlights Theme for Wordpress


If this kind of stuff has any value to you, please consider supporting me so I can do more!

Support me on Patreon Support me on via PayPal


A configurable Wordpress Theme version of HTML5up Highlights Theme made for the internet by @cogdog. It creates a simple, elegant calling card something that looks like

Screenshot of Theme

You can see a demo version at http://lab.cogdogblog.com/highlights/

For simple content, this can be a one page site, but use of the Wordpress more tag allows for longer content on a single post template. The content before the more tag appears on the home page of the site and a more button is inserted to read "the rest of the story."

You also can have standalone single pages available for linking into.

The top/splash screen is configured in the Wordpress Customizer. The backdrop image is managed by the Header Background controls in the Customizer, which means you have an option of loading several images that can be set to appear at random on page load.

Subsequent sections as you scroll down (or use the automatic generated menu) are managed as separate WordPress Posts. If the post has a featured image, on a wide screen the background image will change to it. As the page is scrolled farther, these images continue to change.

Posts without featured images use the default theme header image in the background.

Wordpress content display

Each front section provides bottom arrow navigation to the next section as well as an edit this link for logged in users so they can directly edit the content.

The bottom footer can be customized with a social media icon menu using Font Awesome 5 icons with my other plugin and a custom footer menu text.

Highlights works best for smaller amounts of content in each section, it's meant for high level summaries, and you can use hypertext links to expand to other sites. But still, some people want a lot of content in this site, so a features was added to mark the opening bits of a post to appear on the front, with a link to see expanded content in a single page (see below for more).

Examples

Installing From Reclaim Hosting

If you are wise enough to host your web sites at Reclaim Hosting you have the option of installing a fully functioning site with this theme (a copy of the demo site) including recommended plugins, configured settings and sample content, all done in one click. But wait there is more! With this method of installing your site, future updates to the theme are automatically added to your site.

In your cpanel, under Applications go to All Applications. This theme is available listed under Fratured Applications; just install from there.

Note that unlike other WordPress installs, this one will not preserve your username/password, so be sure to save that information. When it's done, log into your new site and start making it your own.

Installing from Scratch

Install this theme on any self hosted Wordpress site. No luck on Wordpress.com, get a real web hosting package.

You can download a ZIP file of this theme via the green *Code" button above (use the Download Zip option).

The zip can be uploaded directly to your site via Themes in the Wordpress dashboard, then Add Theme and finally Upload Theme. If you run into size upload limits or just prefer going old school like me, unzip the package and ftp the entire folder into your wp-content/themes directory.

Follow the directions below for customizing, some additional plugins may need to be installed.

Updating the Theme

As of WordPress version 5.5 themes uploaded as .ZIP files can now be updated the same way you installed it; just download the newest version, and update it via Themes in the Wordpress dashboard, then Add Theme and finally Upload Theme. You will be asked to confirm updating the theme with the newer version.

If you have ftp/sftp access to your site (or this can be done in a cpanel file manager), simply upload the new theme files to the wp-content/themes directory that includes the older version theme.

Customizing with the Customizer

The main elements are set and previewed in Appearance -> Customize

Site Name. Anything you want!

Under Site Identity edit the title that shows up in the footer as well as an optional description of the site as a tagline.

Use Header Image to Set Top Background

Under Header Image upload an image (recommended size 1024 x 768 px or bigger) to place a background image for the intro section and the footer of the site

Once you have changed it, you will see it immediately previewed on the right.

With the Header image controller you can upload more than one image, and use the option to randomize each time the page loads.

Highlights Mod Content

Other parts of the top of the home page and and the footer are also configured in the Customizer. To include more items on the front, just bump the number listed for Maximum Number of sections (this defines how many "posts" are listed). Change the title and the blurb content (which can include HTML):

The text for Footer Text is used for additional information in the footer:

Social Media Icons

This theme supports the use of a plugin for adding to the footer a menu of social media links.

NOTE Previous versions of the themes used the Font Awesome 4 Menus plugin, which is not compatible with the latest set of Font Awesome icons I have built an update to this plugin in you want access to a larger set of icons. You will also need to add fab to the menu class names (see below)

To have a customized set of icon links on the front of the site, download, install and activate the Font Awesome 5 Menus plugin. This allows you to add an icon to any menu item.

From the Wordpress Dashboard look under Appearances for Menus. Click create a new menu name it whatever you like -- social is a good choice. Under Menu Settings next to Display Location check the box for Social Media.

To add a social media (or any link), open the panel for Custom Link.

Enter a title for the site and provide the URL that points to your content on that site. Add as many as you like. You can drag and drop them to change the order.

To set the icon, you must first enable the visibility of CSS classes for each menu item. Click Screen Options in the upper right, and check the box for CSS Classes.

Open an item in your Social Menu and you will now see a field for entering CSS Class names. You have the choice to add from well over 1400 icons in the Font Awesome free collection. Find the name of the icon you wish to use, and enter it's all of it's class names as listed,

For example these are the class names to render the icon for typical social media sites (these should be all lower case):

  • fab fa-twitter
  • fab fa-facebook
  • fab fa-youtube
  • fab fa-linkedin
  • fab fa-instagram
  • fab fa-flickr

With the Font Awesome icons, you can add any site you wish to be in your footer and pick the icon you prefer.

Save your menu and check out the spiffy icons in the footer.

In addition, if you want to provide a tool tip hover for the icons, look again under Screen Options and enable the option for Title Attribute. This adds another editable field to add the tooltip text.

Editing Content

The content for the blocks are managed as Wordpress Posts. For each block you want create a post. If you want the animated style with a large background image, add a Featured image that is at least 1028 x 768 px in size- big beautiful images.

The order of the sections is controlled via the post sidebar Post Attributes option for... Section Order, lower numbers are displayed higher in the site.

By default a site accommodates up to 10 sections, but this maximum number can be changed in the Customizer.

The Dashboard Posts view will list your sections in the order specified. To change the order quickly, hover a title and use the Quick Edit link to change the value of the order attribute.

Splitting Content into Read More

Okay, you want to write more content than displays well on the front of the site? This theme includes a template for a single post view to read a longer piece of content. You can use the Wordpress Read More feature to mark where in your post to split what appears on the front of the site.

In the Wordpress editor, find the place in your post where you want this split to occur, and use the Read More button to place the marker.

When an Read More has been added to a post, on the front of your site, only the portion above the line is visible, and a more... link is added.

Following the link leads to a single post view that will open to the part of the post below the Read More marker, the featured image in the background

If you were to enter the single post by it's URL, you would see the site header, it's background image, the post title, and the content above the More button.

Pages Too!

You can also create stand alone content that is not part of the scrolling front if you use Pages. The format is similar to single posts, the top of the page uses the site header/background and page title, and a button that jumps down to the page content. See

http://lab.cogdogblog.com/highlights/else/

Got Styles?

Yep. The styles of the HTML5up theme are available; see the demo site for examples. It might require some HTML editing to setup and/or maybe use of CSS classes.

Uh Oh, Room 404

There won't be a great deal of content on a typical site, and to cover a case of a bad link, this, and all other of the themes like this now have a not found page. This generates a list of all posts, followed by any pages, as well as a link to the front.

Try finding room 404!

http://lab.cogdogblog.com/highlights/whereami

Suggested Plugins

  • Font Awesome 5 icons with my other plugin used to add the icons to the social media links in the footer
  • Fluid Video Embeds will make sure your auto embedded videos (and other content wordpress can embed by URL) are responsively sized to fill the column width (if your content column seems to shimmy around on a small screen it's likely a video that is too wide to fit.
  • JetPack can add a number of capabilities, such as adding a contact form or a variety of other image galleries (try Mosaic). If you do create a contact form, make sure you also add and activate Akismet because you will get spam
  • Regenerate Thumbnails If you change to this theme from another one, you should run this plug to re-generate previously uploaded images in the specific sizes used by the theme.

Credits