search

adventistchurch / alps-wordpress

This Wordpress theme is an implementation of the Adventist Living Pattern System (ALPS) designed to support the work of the Seventh-day Adventist Church.
Other
43 stars 38 forks source link
alps alps-wordpress wordpress-theme

readme

ALPS WordPress Theme Setup

Theme installation via WordPress Admin Panel

  1. In your WordPress admin panel, navigate to Appearance->Themes
  2. Click Add New
  3. Click Upload Theme
  4. Upload the zip file that you downloaded.

Theme settings

Set front and posts page

  1. In your WordPress admin panel, navigate to Settings->Reading
  2. Set Front page displays to a static page
  3. Select a page from each dropdown
  4. Save Changes

Set page template

  1. In your WordPress admin panel, navigate to Pages
  2. Edit page
  3. In the sidebar, navigate to Page Attributes
  4. Select Template from the dropdown

Add widgets to sidebar

  1. In your WordPress admin panel, navigate to Appearance->Widgets
  2. Drag widget to widget area
    • Page Top: A region at the top of a Page content type.
    • Page Bottom: A region at the bottom of a Page content type.
    • Page Sidebar: A region at the side of a Page content type.
    • Post Sidebar: A region at the side of a Post content type.
    • Post Footer Region: A region at the bottom of a Post content type.
    • Footer Region: A region at the bottom of any content type.

Add menus

  1. In your WordPress admin panel, navigate to Appearance->Menus
  2. Create a menu
  3. Add links
  4. Go to Manage Locations tab
  5. Select location for the menu to appear
    • Primary Navigation: The main navigation for the page
    • Secondary Navigation: Appears above the main navigation
    • Secondary Footer Navigation: Appears above the main footer navigation
    • Primary Footer Navigation: The main footer navigation at the bottom of the page
    • Tertiary Navigation: Appears below the page header on the News Template

ALPS WordPress Theme Development

ALPS is developed using Sage, from roots.io.

Sage

Sage is a WordPress starter theme with a modern development workflow.

Features

See a working example at roots-example-project.com.

Requirements

Make sure all dependencies have been installed before moving on:

Theme structure

themes/your-theme-name/   # → Root of your Sage based theme
├── app/                  # → Theme PHP
│   ├── carbon-fields     # → Carbon fields plugin for Theme Settings
│   ├── Core              # → Utils functionality for theme support
│   ├── local             # → folder for storing styles on your local env
│   │   ├── alps          # → folder with generated css and js files 
│   │   └── source        # → folder with source css and js files. After generation of this folder files will store in the /alps folder 
│   ├── Providers/        # → Service providers
│   ├── View/             # → View models
│   ├── filters.php       # → Theme filters
│   └── setup.php         # → Theme setup
├── devtools/             # → Build, release scripts for release theme 
├── composer.json         # → Autoloading for `app/` files
├── 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
│   ├── images/           # → Theme images
│   ├── scripts/          # → Theme javascript
│   ├── styles/           # → Theme stylesheets
│   └── views/            # → Theme templates
│       ├── components/   # → Component templates
│       ├── forms/        # → Form templates
│       ├── layouts/      # → Base templates
│       └── partials/     # → Partial templates
├── screenshot.png        # → Theme screenshot for WP admin
├── style.css             # → Theme meta information
├── vendor/               # → Composer packages (never edit)
└── bud.config.js         # → Bud configuration

Theme setup

Edit app/setup.php to enable or disable theme features, setup navigation menus, post thumbnail sizes, and sidebars.

Theme development

Localization

Theme uses WordPress recommended way to localize with *.po files. Localization template located in lang/alps.pot. To add new language special software should be used (ex. POEdit).

To perform scan of new localizable strings in source files, run npm run i18n-create-pot.

WPML plugin recommended for the multilingual websites. Theme provides autogenerated file lang/alps.php to help WPML scan the strings for translation.

Translators:

The translation in ALPS for Wordpress was done thanks to the following individuals:

Build commands

Documentation

Contributing

Contributions are welcome from everyone. We have contributing guidelines to help you get started.

Community

Keep track of development and community news.

Troubleshooting

Cache Error vendor/illuminate/view/Engines/PhpEngine.php on line 43:

Add Secondary Nav icons