MTT's WordPress starter theme Built off of Sage 10 by roots

MTT Boilerplate Notes

Getting Started

Run composer install from the root of the theme
If you do not have yarn, install yarn by running npm install --global yarn
Once you have yarn, run yarn from the theme directory to install dependencies
Choose which css pre-processor you would like to use in webpack.mix.js. Both LESS (default) and SASS available.
To use Browsersync be sure to set your local dev url .browserSync('your-local-dev-url.test');

If using less, start with editing the variables.less file.

Development

yarn start — Compile assets when file changes are made, start Browsersync session
yarn build — Compile and optimize the files in your assets directory
yarn build:production — Compile assets for production

Wordpress set up

Edit app/setup.php to enable or disable theme features, setup navigation menus, post thumbnail sizes, and sidebars.
Add custom filters to app/filters.php
Add custom helper functions to app/helpers.php

HTML and Blade Templates

This Boilerplate has removed the original Sage code from index.php.
- You can find the primary layout in resources/views/layouts/app.blade.php
- You can find the <head> in resources/views/layouts/header.blade.php
- You can find the closing </body> in resources/views/layouts/footer.blade.php
Any blade components created in resources/views/components can be used in other blade files using this syntax:

/views/components/my-component.blade.php:
<x-my-component />
OR
/views/components/folder/my-component.blade.php
<x-folder.my-component />

Blade components can only have 1 root elements

Correct:
______________
<div>
    <h1>Hello World</h1>
    <h2>Hello Moon</h2>
</div>

Wrong:
______________
<h1>Hello World</h1>
<h2>Hello Moon</h2>

You can pass a variable to a component. Example: We can set my-component's $foo variable as $bar

<x-my-component :foo="$bar" />

For more on blade, see https://laravel.com/docs/8.x/blade
Too create a new wordpress template, copy and paste the template-custom.blade.php found in resources/views. Then update the Template_Name: comment at the top of the file.
You can do php in blade 2 ways
- For a single line of php you can use @php() ie. @php($foo = 'bar')
- For multiple lines of php you can use @php @endphp ie
```
@php
    $foo = array('item', 'item');
    do_someting($foo[0]);
@endphp
```
- Note: we noticed that sometimes @php does not work. use <?php ?> instead if that's the case

Advanced Custom Fields Pro

We commonly use Advanced Custom Fields Pro. Fields can be grabbed easily using this syntax @php($foo = get_field('foo'))
To see the contents / array of the above $foo you can use @dd() ie. @dd($foo). This will print the $foo values to the page.

Example:

@php($flexible = get_field('flex_content'))
@if($flexible)
    @foreach ($flexible as $flex)
        @if($flex['acf_fc_layout'] == 'my-component')
            <x-my-component :component="$flex" />
        @endif
    @endforeach
@endif

Components Library

A library of components containing html, js, css, and php can be cloned into your [THEME_ROOT]/resources/ directory. These can be easily copied and pasted in your project.
- git clone git@github.com:stealth-media/component_library.git
** Please delete the resources/components_library when project is complete. **

JS

Use resources/scripts/app.js for main js scripts.
Find JavaScript snippets @ resources/component_library/snippets.js
When installing new scripts with npm be sure to include the package at the top of resources/scripts/app.js. ie npm install slideout

import Slideout from 'slideout';

jQuery is supported out of the box

Grid & Bootstrap

https://getbootstrap.com/docs/4.5/layout/grid/

The bootstrap grid is applied and can be found at resources/less/common/bootstrap/grid.less. To enable bootstrap css, uncomment "bootstrap.less" from app.less
See resources/less/common/mixins.less for breakpoint mixins. ie. .lg(), .md(), .sm(), etc. These breakpoints mixins can be used to apply media query styling at to correct grid breakpoints. Breakpoint dimensions are written in comments of mixins

Example:
```
nav {
  font-size:20px;
  .md({
    font-size:15px; // applied to md and smaller
  });
}
```

Menus

This Boilerplate includes a prebuilt Nav and Mega Nav
- Find HTML @ resources/views/partials/nav.blade.php and resources/views/partials/mega-nav.blade.php. Include the nav you are using above #panel in resources/layouts/header.blade.php
- Find CSS @ resources/less/header.less
- Find JS @ resources/scripts/app.js scroller()
This Boilerplate has been set up with a working Mobile Nav. Slideout js has been included for use in mobile nav.
- Find HTML @ resources/views/partials/mobile-menu.blade.php which has been included in resources/views/layouts/header.blade.php,
- CSS @ resources/less/layouts/mobile-menu.less
- JS to handle slide out and nav buttons @ resources/scripts/app.js mobileMenu()
- Note: When the mobile menu is activated, #panel will slide. If you have position: fixed; elements outside of #panel ie. the nav, be sure to add the class .fixed-to-panel. This will slide your fixed elements with the panel.

Scroll to animations

This Boilerplate includes ready to use scroll to animations
To use a scroll to animation, add the class .animation-element to an element you want to trigger a scroll to animation on. Once this element is in view, it will trigger the animation for itself and it's children.
You can find a library of animations in resources/less/common/animations.less
- add the animation classes to elements you want to animate. (be sure the class in uncommented in animations.less)
Example:

Once #my-div is in view, it will fade in
```
<div id="my-div" class="animation-element fade-in">Foobar<div>
```
Once #my-div is in view, it's children will fade in.
```
<div id="my-div" class="animation-element">
    <div class="fade-in">Foobar</div>
    <div class="fade-in">Foobar</div>
    <div class="fade-in">Foobar</div>
<div>
```
Note: you do not need animation-element on every element you want to animate. .animation-element is just the element that triggers the animations once it's in view for itself and it's children.

Delays

You may not want all children to animate at the same time. You can delay their animation by using the .aniamtion-delay-# class (see animations.less for list of animation delays)

Example:
```
 <div id="my-div" class="animation-element">
      <div class="fade-in">Foobar</div> // Fades in first
      <div class="fade-in aniamtion-delay-2">Foobar</div> // Fades in 2ms later
      <div class="slide-in-right aniamtion-delay-4">Foobar</div> // Slides in 4ms later
 <div>
```
You can find the javascript that controls the triggering of these animations at resources/scripts/app.js animateOnScroll()

Requirements

Make sure all dependencies have been installed before moving on:

WordPress >= 5.4
PHP >= 7.3.0 (with php-mbstring enabled)
Composer
Node.js >= 12.14.0
Yarn

Theme installation

To add theme to your project simply git clone git@github.com:stealth-media/sage.git from your root themes directory

Theme structure

themes/sage/                # → Root of your Sage based theme
├── app/                    # → Theme PHP
│   ├── View/               # → View models
│   ├── Providers/          # → Service providers
│   ├── admin.php           # → Theme customizer setup
│   ├── filters.php         # → Theme filters
│   ├── helpers.php         # → Helper functions
│   └── setup.php           # → Theme setup
├── bootstrap/              # → Acorn bootstrap
│   ├── cache/              # → Acorn cache location (never edit)
│   └── app.php             # → Acorn application bootloader
├── config/                 # → Config files
│   ├── app.php             # → Application configuration
│   ├── assets.php          # → Asset configuration
│   ├── filesystems.php     # → Filesystems configuration
│   ├── logging.php         # → Logging configuration
│   └── view.php            # → View configuration
├── composer.json           # → Autoloading for `app/` files
├── composer.lock           # → Composer lock file (never edit)
├── public/                 # → Built theme assets (never edit)
├── functions.php           # → Theme bootloader
├── index.php               # → Theme template wrapper
├── node_modules/           # → Node.js packages (never edit)
├── package.json            # → Node.js dependencies and scripts
├── resources/              # → Theme assets and templates
│   ├── fonts/              # → Theme fonts
│       ├── @fortawesome/   # → Fontawesome fonts 
│   ├── images/             # → Theme images
│   ├── scripts/            # → Theme javascript
│       ├── app.js/         # → Main js file. 
│   ├── less/               # → Theme less styles
│       ├── common/         # → Commonly used less styles, not particular to a component or page
│       ├── components/     # → Component Less style. used in sync with view/components
│       ├── layouts/        # → Base Layout less styles
│       └── app.less        # → Main less file. include all new less files here
│   ├── sass/               # → Theme sass styles
│       ├── common/         # → Commonly used sass styles, not particular to a component or page
│   ├── styles/             # → Theme stylesheets
│   └── views/              # → Theme templates
│       ├── components/     # → Component templates
│       ├── content/        # → Content templates. Used for inside wordpress loops
│       ├── form/           # → Form templates
│       ├── layouts/        # → Base templates
│       └── partials/       # → Partial templates
├── screenshot.png          # → Theme screenshot for WP admin
├── storage/                # → Storage location for cache (never edit)
├── style.css               # → Theme meta information
├── vendor/                 # → Composer packages (never edit)
├── tailwind.config.js/     # → Tailwind configuration
└── webpack.mix.js          # → Laravel Mix configuration

Documentation

Sage documentation

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README.md

README.md

MTT Boilerplate Notes

Getting Started

Development

Wordpress set up

HTML and Blade Templates

Advanced Custom Fields Pro

Components Library

Please delete the `resources/components_library` when project is complete.

JS

Grid & Bootstrap

Menus

Scroll to animations

Delays

Requirements

Theme installation

Theme structure

Documentation

Files

README.md

Latest commit

History

README.md

File metadata and controls

MTT Boilerplate Notes

Getting Started

Development

Wordpress set up

HTML and Blade Templates

Advanced Custom Fields Pro

Components Library

** Please delete the resources/components_library when project is complete. **

JS

Grid & Bootstrap

Menus

Scroll to animations

Delays

Requirements

Theme installation

Theme structure

Documentation

Please delete the `resources/components_library` when project is complete.