Ambrosia: Tips and Tricks

Introduction

The Ambrosia design for phpBB comes with several features that set it apart from other phpBB styles. We have outlined some tips and tricks to help you make the most of the style below.

Modules

Our demo of Ambrosia features several modules which demonstrate what you can do with Ambrosia in phpBB 3.1. If you would like to replicate these modules, we recommend downloading the RocketLauncher and installing it on a local test server. There, you will have access to the source files and settings for these modules so you can easily replicate them. Alternatively, you can build your site based on the RocketLauncher and modify these modules to meet your individual needs.

You can find the Twig files used to create the modules in the phpbb_root/styles/your_style/template/modules directory. For a specific module, you will want to find the Twig file with the same name of the module you wish to replicate. For example, the module titled Contact Us is loaded from phpbb_root/styles/your_style/template/modules/contact.html.twig.

If you would like more information on how these modules are assembled and installed in phpBB 3.1, check out our RokBB user guide.

Colors for Rounded Avatar Containers

Ambrosia contains improved main forum layout. Layout is based on user avatars and customizable containers. It shows last user avatar image instead forum icon or first topic/forum letter. It also adds a status indicator which notifies users about new topics or special actions.

You can edit the color settings for both the avatar's background and the letter overlay by navigating to Customise in the admin, selecting Style Settings under the RocketTheme Styles section of the sidebar, and opening the Style tab. The options are listed as Forumicon Background Color and Forumicon Letter Color.

SCSS Compiler

To start using the SCSS compiler right away, you can do so using a _custom.scss file. This file is located inside style directory: ~/styles/ambrosia/theme/scss/phpbb/_custom.scss. Changes you make here will be saved and automatically recompiled during your next forum visit. If you're not familiar with SCSS, you can find more information about this compiler be visiting its official documentation.

If you want to add your own SCSS file for compilation, open template/modules/styledeclaration.html.twig, find the core section:

{# Core Theme #}

and add something like that

{% INCLUDECSS scss_compiler ~ 'scss/your_file_name.scss' %}

This will load your custom SCSS file, but your custom SCSS file has to be uploaded into the ~/styles/ambrosia/theme/scss/ directory.

Animation

The animated elements that trigger as you scroll down the page are handled via classes applied to HTML elements, icons etc. You can access Ambrosia's main settings area by navigating to Admin > Styles > Ambrosia. From here, you will want to select the Imageset Editor tab where you can find the Forum Icons settings. In these fields, you can enter the tag of the animation(s) you wish to use. You can find a list (as well as visual examples) of these animation classes here.

In our demo, we used the following in the three Forum Icons field.

The class name wow zoomIn sets the animation of each component to zoom in. The wow portion is the prefix, and zoomIn is the name of the animation. The fa fa-(name) classes set the Font Awesome icon used for each component.

Newsflash

The Style settings feature a special tab called Newsflash. This section directly controls the content that appears in the newsflash module on the front page. The settings here are very straightforward. Here is a breakdown of the options: