Giters

dhornbein / democrats.com

Wordpress theme for Democrats.com

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Democrats.com Theme

Files you'll care about

  • sass/_theme.scss main style sheet, all custom scss is here it uses sass
  • sass/_theme_variables.scss this contains all custom sass variables (see below for more info)
  • front-page.php main wp template where all the magic happens
  • loop-templates/home-*.php these template parts manage all the content that shows up on the front-page.php via get_template_part() function
  • header.php this is the top bit
  • footer.php this is the bottom bit
  • sidebar-footerfull.php this manages the wrapper for the footer

Outline

The theme has a front page and single post pages.

The home page consists of three main sections:

  • hero post
  • featured posts
  • about section

The home page is constructed using front-page.php and is basically just a blog roll. It displays the most recent posts.

Logo and Tagline

You'll need to set the logo and tagline for the site. Tagline shows up at the top, logo will display in the header.

Hero Post

The "top" post will be displayed prominently at the top of the site. It will either be the most recent or the most recent stick post. e.g. if you want an older post to show up at the top, make it sticky. If the post has a featured image it will show up in the background with a blue overlay.

The first post in the loop gets treated to the loop-template/home-hero.php template. The overlay color is set using $hero-bk-overlay in the variables file.

Featured Posts

These are just the rest of the posts. There is currently no limit to how many will show up. You can make posts private or draft if you no longer want them to show up.

The code for these is in loop-template/home-post.php.

About section

If there is a page with a slug of "about" it will show up here. You can set the title of the page to what ever you want as long as the slug (or permalink) is set to "about".

The code for this is in loop-template/home-page.php

Post Formats

This theme supports post formats and will display some formats differently:

  • Video - Post's content area is widened to give embedded videos more room.

Custom tweet message

Any post can change the default share tweet text that appears after the user clicks share via twitter. Adding a custom field a post with the name 'tweet' and the custom message. Note: you'll have to make sure it's less than ~100 characters to account for the link and "via @demoratscom"

Footer

The footer is a widget area. Each widget is 1/3 wide, meaning that if you add three widgets they will flow out into three rows (assuming the screen is wide enough). The first will be the left most, 2nd middle, and third right. If you add more than three they will wrap and start all over again, probably wont look good. If you want to have just one widget on the right you'll need to make 2 blank "text" widgets to push it over.

The footer is starts with footer.php and the wrapper for the widget area can be found in sidebar-footerfull.php the code that wraps each widget can be found in inc/widgets.php under the footerfull register_sidebar() element (near the bottom).

Notes

Read the below stuff to understand how the system works.

I'm using mobile first design so the site currently looks decent on mobile and not so great on larger screens.

About Understrap

Start talking: Gitter

Official Docs Page: Open Docs

About

I’m a huge fan of Underscores, Bootstrap, and Sass. Why not combine these into a solid WordPress Theme Framework? That’s what UnderStrap is. You can use it as starter theme and build your own theme on top of it. Or you use it as parent theme and create your own child theme for UnderStrap.

At the moment, UnderStrap is in a very early stage. But if you want, feel free to use it for your own WordPress theme!

UnderStrap WordPress Theme Framework

Website: https://understrap.com

Child Theme Project: https://github.com/holger1411/understrap-child

License

UnderStrap is released under the terms of the GPL version 2 or (at your option) any later version.

http://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html

Changelog

See changelog

Basic Features

  • Combines Underscore’s PHP/JS files and Bootstrap’s HTML/CSS/JS.
  • Comes with Bootstrap (v4) Sass source files and additional .scss files. Nicely sorted and ready to add your own variables and customize the Bootstrap variables.
  • Uses a single and minified CSS file for all the basic stuff.
  • Font Awesome integration (v4.7.0)
  • Comes with extra slider script by Owl Carousel (v2.1.4)
  • Jetpack ready.
  • WooCommerce support.
  • Contact Form 7 support.
  • Child Theme ready.
  • Translation ready.
  • Multiple Page Templates

Starter Theme + HTML Framework = WordPress Theme Framework

The _s theme is a good starting point to develop a WordPress theme. But it is “just” a raw starter theme. That means it outputs all the WordPress stuff correctly but without any layout or design. Why not add a well known and supported layout framework to have a solid, clean and responsive foundation? That’s where Bootstrap comes in.

Confused by All the CSS and Sass Files?

Some basics about the Sass and CSS files that come with UnderStrap:

  • The theme itself uses the /style.cssfile just to identify the theme inside of WordPress. The file is not loaded by the theme and does not include any styles.

  • The /css/theme.css and it´s minified little brother /css/theme.min.css file(s) provides all styles. It is composed of five different SCSS sets and one variable file at /sass/theme.scss:

                - 1 "theme/theme_variables";  // <--------- Add your variables into this file. Also add variables to overwrite Bootstrap or UnderStrap variables here
            - 2 "../src/bootstrap-sass/assets/stylesheets/bootstrap";  // <--------- All the Bootstrap stuff - Don´t edit this!
            - 3 "understrap/understrap"; // <--------- Some basic WordPress stylings and needed styles to combine Boostrap and Underscores
            - 4 "../src/fontawesome/scss/font-awesome"; // <--------- Font Awesome Icon styles

            // Any additional imported files //
            - 5 "theme/theme";  // <--------- Add your styles into this file

  • Don’t edit the files no. 2-4 files/filesets or you won’t be able to update it without overwriting your own work!

  • Your design goes into: /sass/theme. Add your styles to the /sass/theme/_theme.scss file and your variables to the /sass/theme/_theme_variables.scss. Or add other .scss files into it and @import it into /sass/theme/_theme.scss.

Installation

Classic install

  • Download the understrap folder from GitHub or from https://understrap.com
  • IMPORTANT: If you download it from GitHub make sure you rename the "understrap-master.zip" file just to "understrap.zip" or you might have problems using child themes !!
  • Upload it into your WordPress installation subfolder here: /wp-content/themes/
  • Login to your WordPress backend
  • Go to Appearance → Themes
  • Activate the UnderStrap theme

npm install

  • Open your terminal
  • Change to the directory where you want to add UnderStrap
  • Type npm install understrap

WordPress.org install

  • Open your WordPress backend
  • Click on "Appearance -> Themes"
  • Hit the "Add new" button
  • Search for "UnderStrap"
  • Hit the "install" button
  • Activate the theme

Developing With npm, Gulp and SASS and [Browser Sync][1]

Installing Dependencies

  • Make sure you have installed Node.js and Browser-Sync* (* optional, if you wanna use it) on your computer globally
  • Then open your terminal and browse to the location of your UnderStrap copy
  • Run: $ npm install

Running

To work and compile your Sass files on the fly start:

  • $ gulp watch

Or, to run with Browser-Sync:

  • First change the browser-sync options to reflect your environment in the file /gulpfile.js in the beginning of the file:
var browserSyncOptions = {
    proxy: "localhost/theme_test/", // <----- CHANGE HERE
    notify: false
};
  • then run: $ gulp watch-bs

How to Use the Build-In Widget Slider

The front-page slider is widget driven. Simply add more than one widget to widget position “Hero”.

  • Click on Appearance → Widgets.
  • Add two, or more, widgets of any kind to widget area “Hero”.
  • That’s it.

RTL styles?

Just add a new file to the themes root folder called rtl.css. Add all alignments to this file according to this description: https://codex.wordpress.org/Right_to_Left_Language_Support

Page Templates

Blank Template

The blank.php template is useful when working with various page builders and can be used as a starting blank canvas.

Empty Template

The empty.php template displays a header and a footer only. A good starting point for landing pages.

Full Width Template

The fullwidthpage.php template has full width layout without a sidebar.

Vertical One Page Template

The vertical-one-page.php template displays all pages (except the one showing the posts) in a single vertical layout with a sliding navigation. Additionally enables the user to control the order of each page by using the order page attribute field.

One Page Template How to

  1. Assuming that you have the following pages: Home, About and Contact
  2. Go to Appearance → Menus and add one custom link for each page
  3. On the URL field type a hash # and the name of the page in lower case so for example the link for Home becomes #home
  4. Edit the Home page and set as template the Vertical One Page (you only need to do this for the first page)
  5. Set the order of each page using the Order field from Page Attributes so for example if you want to display Home, Contact, About set the Home page to 1, the Contact to 2 and About to 3

[1] Visit http://browsersync.io for more information on Browser Sync

Licenses & Credits

Analytics

About

Wordpress theme for Democrats.com

Languages

Language:CSS 39.8%Language:JavaScript 33.1%Language:PHP 27.1%