Angularized Help Documentation

Introduction

Thank you!

Thank you for purchasing the Angularized Tumblr theme. I hope the theme serves you finely in building your new website or giving a new look to your existing one!

About Angularized

The Angularized theme can be installed on any Tumblr-driven Website. It makes use of the Tumblr API for crunching its data, and is built on the popular AngularJS framework, delivering a beautiful , fast-loading and unique user experience without the need for a browser refresh between one Post and the other.

The theme also enhances your normal Tumblr Blog with some unique features like

  • A Full Navigation Menu
  • A Configurable "Hero Panel" for your Home Page.
  • Capturing and sending out data from a fully customized Form to your Inbox
  • Inserting a Call to Action prompt to each of your Posts effortlessly

Last but not least, the Angularized theme integrates seamlessly with services such as Mailchimp and Disqus

A great template for Artisans and Artists selling their products online, fashion or food bloggers!


Installation

Installing the Angularized theme

Now you've got your new Tumblr theme you'll want to install it right away!

Unzip your download folder and locate the Angularized.html file, it will be in the root of the folder.

Open that in your favourite text editor. Don't open it in a web browser as it will look a mess. Instead right click and select Open... I use Sublime Text 3 for the Mac. But there are free programs such as TextWrangler for Mac and Notepad++ for PC. Every PC comes with NotePad installed for free as well. If you've opened up the HTML file in TextEdit it may have messed it up completely. Bad times. If you follow this guide: http://support.apple.com/kb/TA20406. It'll show you how to open HTML files properly within TextEdit.

Now you've got the file open, select everything within it either by dragging your cursor from the beginning of the first line all the way to the bottom, or by pressing CMD + A (Mac) or CTRL + A (PC). Now copy all of that selected code by going to Edit then clicking Copy or by pressing CMD + C (Mac), CTRL + C (PC). That code is now stored on your clipboard.

The Customise Screen and the HTML Editor

Log into your Tumblr Dashboard, then click on the Account icon at the very top of the site, then click on the "Settings" option.

Now select the blog you would like to install the theme on from the list on the right.

Now click on the "Edit theme" button.This opens up Tumblr's Customise Screen. Pressing "Edit HTML" will send you to Tumblr's HTML Editor.

Delete all the code in this area.

Now go ahead and paste in the new code. CMD + V (Mac) or CTRL + V (PC) will paste in the code quicker than a flash. Or you can go up to the Edit menu item and click on Paste. Either way works fine.

Now hit the Update Preview button. You'll notice the preview on the right updates with your new theme.

Now take note, the Preview of the theme will ALWAYS look weird; this is NORMAL, as the theme is using the Tumblr API as its engine, along with the angular Framework. The Tumblr Preview will not be able to really show all that, but your theme will still look perfect through its normal URL.

So go ahead and hit the green "Update Preview" button and then click the blue "Save" button. Refresh this page now (F5 or right click and click Reload / Refresh). Now your new themes options have loaded in. You'll need to set some of the most basic options before checking out your brand new website so patience!!!

Now you can head on to the Set Up area of this document to find out how to make your theme look the way you want.

Uploading the Vendors Javascript file

This file keeps all the third party libraries and scripts used by the Angularized theme and the location path for the file is set by default on the "Vendors source" option. Leave this path as is if you want to always show the most recent and updated version of the Angularized theme.

Installing the Core Javascript source

This file keeps all the Javascript directives used by the Angularized theme and the location path for the file is set by default on the "Core source" option. Leave this path as is if you want to always show the most recent and updated version of the Angularized theme.

Installing the CSS source

This file keeps all the CSS styling used by the Angularized theme and the location path for the file is set by default on the "CSS source" option. Leave this path as is if you want to always show the most recent and updated version of the Angularized theme.

Image displaying the options relative to the Sources needed for the Angular theme to work. ("Vendors Source", "CSS source" and "Core Source" options)


Basic Configuration

Define The Content Source : Native or External

The Angularized theme is the very first of its kind, using the tumblr API for delivering content.

This means that you can practically use ANY tumblr Blog out there, and serve it through a new web address.

It sounds a bit hard to grasp in the beginning, but it is a concept with infinite possibilities. As an example and proof of concept, you can check how the Demo Tumblr for Angularized theme is set: The content you see up there is actually using the content uploaded to the famous Scipsy Blog.

You can define the Content Source by inserting a Tumblr address on the "Blog address" option of the Angularized theme.

If you intend to use a "Native" Content source, then simply fill the "Blog address" option with the URL of the blog you're installing the theme onto (ommit the 'http://' prefix).

Upload a Logo

That's an easy one, just use the "Logo", "Logo Alt" and "Logo Height" To configure your site's logo.

Tip: For best performance, upload an image that has the double height of the one you will set in the "Logo Height" option. (For an image of natural height of 128px, set the "Logo Height" option to "64px". This will make sure your logo will show great on Retina screens (2X images)

Description

If you have chosen to show the Description of your blog, then it will show on the Grey bar right on the top of the Interface

Back to Store Button

A great way to connect your blog to your e-commerce site, or an external link with which you or your business is somehow connected. All you need to do is configure the "Back to Store Text" option and the "Back to Store Link" option!

Image showing both the "Description" and "Back to Store" Options

Call to Action Button

This is a great way to prompt the user's actions while reading a Post, as the button will tease the user to perform an action you can define through the use of the "Call to Action Text" and "Call to Action Link" options of the theme. If you don't want to use this feature, just leave those fields empty!

Social Share Buttons

Use the Options called Facebook, Instagram, Pinterest, Twitter, Etsy for having your Social Profiles appear on the footer area of your site!

Disqus Integration

To set up the commenting system on the posts permalink pages you will need to sign up to www.disqus.com.

Once you've created your new blog settings there copy your disqus shortname and paste it into the theme options panel. ("Disqus" option)

MailChimp Integration

Angularized provides an easy way to connect your own Mailchimp Newsletter list to the theme's footer. Here's how to activate the Mailchimp Newsletter input:

  1. Log into your Mailchimp Account
  2. Click on "Lists" from the sidebar
  3. Click on the list that you'd like connected with your Angularized tumblr
  4. Click "Signup forms"
  5. Select "Embedded forms"
  6. Select "Naked"

You now can obtain the following information from the form action attribute code:

  • mailchimp.username - Your MailChimp username, immediately follows http://

    Once you have that data, you can use the Mailchimp Username option of the theme

  • mailchimp.dc - Your MailChimp distribution center, immediately follows your username

    Once you have that data, you can use the Mailchimp DC option of the theme

  • mailchimp.u - Unique string that identifies your account.

    Once you have that data, you can use the Mailchimp userHash option of the theme

  • mailchimp.id - A unique string that identifies your list.

    Once you have that data, you can use the Mailchimp ID option of the theme

Example::

< form action="http://username.us1.list-manage.com/subscribe/post?u=a9c2c3f4e3t6g7k8i0j0&id=fkwb12" method="post" id="mc-embedded-subscribe-form" name="mc-embedded-subscribe-form" class="validate" target="_blank" novalidate >

Result:

  • Mailchimp Username - username
  • Mailchimp DC - us1
  • Mailchimp userHash - a9c2c3f4e3t6g7k8i0j0
  • Mailchimp ID - fkwb12



The Hero Panel

The "Hero Panel" is the first visual your visitor will encounter on the site. Its purpose is to present an overview of the site's most important content.

The Hero Panel will display the most recent Photo Post Types or even Video Post Types marked with the specified tag. Check here if you want to learn how to tag your Posts.

The Theme will automatically calculate the best possible fit for your images, no matter what their dimensions will be!

The Hero Panel will show only on the Home Page of your site while it is hidden from view on mobile views to save up valuable screen real-estate space!

Setting the Hero Panel related options in the back-end of Tumblr: The Demo Tumblr for Angularized theme uses the tag "astronomy" for creating its Hero Panel, with six Posts format. This means that the 6 most recent posts tagged with the "#astronomy" tag will show up here.

Choosing the Hero Tag

You can choose the tag you want by simply defining it under the "Hero Tag" Option.

Choosing the Layout Format

You can choose the Hero Panel Layout Format by simply typing "4", "5", or "6" under the "Hero Format" Option.

The hero panel will display 4, 5, or even 6 posts tagged with the tag you choose.

The six-post layout of the Hero Panel.

The five-post layout of the Hero Panel.

The four-post layout of the Hero Panel.



The Article Aggregator

One of the most amazing features of the Angularized theme is its ability to aggregate the Posts of your Tumblr blog, based on the "active tag" of the current Post a user is browsing.

On the Home Page, this feature is behaving differently than what it does on a Post-specific Page.

You can control the Hover State of an aggegated article Box, deciding whether to show or hide more info relative to that Post by defining the state of the "Show Text on Hover" option.

If you want to give more visibility to this great feature, then go ahead and activate the "Fix More Posts Button" option : This action will make sure the Aggregator will always "stick" on the user's screen!

The "Show More Posts Text" option will set the text of the Aggregator button on a Post-specific page, while the "Show More Posts Home Text" will define the text of the Aggregator button for the Home Page View.

Home Page feature : Showing all posts

On the Home Page, the Posts aggregator will retreive every Post in your Blog, in chunks of 12 posts each time it is pressed, creating a grid under a "User-Triggered Infinite Scroll" logik, starting from the most recent Posts. This is a great way for the User to check out just about everything that's going on in your blog, without even having to refresh the Page!

Post-Specific Page : Aggregating Posts based on the article's "Active Tag"

Based on the Tag set for each Navigation Sub-level Menu Item, the Article Aggregator will filter out the Posts of your Blog, showing only the posts that contain the tag of the active category. This feature helps the user to stay focused and continue reading Articles that are related to the current choice.

The "Active Tag" for each menu item can be set by the relative "MenuItemXX TagX" option for that menu item.

The Image below shows how the Article Aggegator behave when we click on "Galaxies" Menu Item on the Demo Website: In this case, we have set the "MenuItem01 tag2" option to "galaxy", thus configuring the Article Aggegator to filter out all Posts that contain that tag.


Mobile View

So you've downloaded and installed your new Tumblr theme and you want to get rid of the boring default Tumblr mobile layout. OK so what you need to do first is make sure your in the Customise screen. Scroll down and click on the 'Advanced' button. This drops down some more options. Simply untick the 'Use optimized mobile layout' option and hit the green Save button.

And... YOUR DONE! Now go and enjoy your nice new mobile friendly blog.


Theme Options

Below is a list of ALL the theme options added into this theme. Customise these options for a unique version of the Angularized theme.

Colors

Theme Option Description Default Value
Theme Color Change the theme main color. Influences, links, button, inputs and just about anything that has a color on the GUI. #9C3134
Theme Hover Color Change the theme Hover color. Influences, links, button, inputs and just about anything that has a color on the GUI. #C43239

Tick Box Options

Theme Option Description Default Value
Make the "More Posts" Button sticky so that it doesn't scroll.Check The Article Aggregator for more info. true
Show Text On Hover Show or hide text information of the retreived Posts, when hovering the elements.Check The Article Aggregator for more info true
Show MenuItem00 Show / hide the first Navigation Tab. Check Root Level Configuration for more info. true
Show MenuItem01 Show / hide the second Navigation Tab. Check Root Level Configuration for more info. true
Show MenuItem02 Show / hide the third Navigation Tab. Check Root Level Configuration for more info. true
Show MenuItem03 Show / hide the fourth Navigation Tab. Check Root Level Configuration for more info. true
Show MenuItem04 Show / hide the fifth Navigation Tab. Check Root Level Configuration for more info. true
Show MenuItem05 Show / hide the sixth Navigation Tab. Check Root Level Configuration for more info. true
Show MenuItem06 Show / hide the seventh Navigation Tab. Check Root Level Configuration for more info. true

Upload Images

Theme Option Description Default Value
Logo Upload your logo for the header.

Text Inputs

Theme Option Description Default Value
Logo Alt Define the title of your logo shown on the header.
Logo Height Define the height of your logo shown on the header, in pixels. For taking care the retina screens, you may want to set this to half the value of the logo's natural height (example: For an image of 128px of height, set the "Logo Height" option to "64px".
Blog Address Define the content Source for your Blog. Example: 'scipsy.tumblr.com' , or 'elettraministeri.tumblr.com'.
Do NOT use any 'http://' or 'wwww' prefix before the URL.
Check "Define The Content Source" for more info.
Hero Format simply type '4' , '5', or '6' for configuring one of the available layouts for the Hero Panel. Check "Choosing the Hero Tag" for more info. 6
Hero Tag Insert the tag you want for populating the Hero Panel on the Home Page. Check "Choosing the Layout Format" for more info.
simply type '1' , '2', or '3' for configuring one of the available layouts for the Hero Panel. Check "Choosing the Hero Tag" for more info. 3
Insert the tag you want for populating the Featured Panel on the Home Page. Check "Choosing the Layout Format" for more info.
Call to Action Text Controls the text of the button appearing below the text of every post. Check "Call to Action Button" for more info.
Controls the link of the button appearing below the text of every post. Check "Call to Action Button" for more info.
Back to Store Text Controls the text of the button appearing on the right side of the Header Area. Check "Back to Store Button" for more info.
Controls the link of the button appearing on the right side of the Header Area. Check "Back to Store Button" for more info.
Show More Posts Text Define the text of the Aggregator button for the Specific (permalink) Page View.N.B. for those pages, after the text you define, the "Active Tag" of the page appears automatically. Check The Article Aggregator for more info.
Show More Posts Home Text Define the text of the Aggregator button for the Home Page View. Check The Article Aggregator for more info.
Define the text for the first Menu Item Parent. Check Root Level Configuration for more info.
Define the text for the second Menu Item Parent.
  • Title: MenuItem01 title1. Define the link by using the MenuItem01 id1 and the Active Tag by using the MenuItem01 tag1
  • Title: MenuItem01 title2. Define the link by using the MenuItem01 id2 and the Active Tag by using the MenuItem01 tag2
  • Title: MenuItem01 title3. Define the link by using the MenuItem01 id3 and the Active Tag by using the MenuItem01 tag3
  • Title: MenuItem01 title4. Define the link by using the MenuItem01 id4 and the Active Tag by using the MenuItem01 tag4

Check Root Level Configuration for more info.
Define the text for the third Menu Item Parent.

Sublevel Menu items :

  • Title: MenuItem02 title1. Define the link by using the MenuItem02 id1 and the Active Tag by using the MenuItem02 tag1
  • Title: MenuItem02 title2. Define the link by using the MenuItem02 id2 and the Active Tag by using the MenuItem02 tag2
  • Title: MenuItem02 title3. Define the link by using the MenuItem02 id3 and the Active Tag by using the MenuItem02 tag3
  • Title: MenuItem02 title4. Define the link by using the MenuItem02 id4 and the Active Tag by using the MenuItem02 tag4
Check Root Level Configuration for more info.
Define the text for the fourth Menu Item Parent.

Sublevel Menu items :

  • Title: MenuItem03 title1. Define the link by using the MenuItem03 id1 and the Active Tag by using the MenuItem03 tag1
  • Title: MenuItem03 title2. Define the link by using the MenuItem01 id2 and the Active Tag by using the MenuItem03 tag2
  • Title: MenuItem03 title3. Define the link by using the MenuItem03 id3 and the Active Tag by using the MenuItem03 tag3
  • Title: MenuItem03 title4. Define the link by using the MenuItem03 id4 and the Active Tag by using the MenuItem03 tag4
Check Root Level Configuration for more info.
Define the text for the fifth Menu Item Parent.

Sublevel Menu items :

  • Title: MenuItem04 title1. Define the link by using the MenuItem04 id1 and the Active Tag by using the MenuItem04 tag1
  • Title: MenuItem04 title2. Define the link by using the MenuItem04 id2 and the Active Tag by using the MenuItem04 tag2
  • Title: MenuItem04 title3. Define the link by using the MenuItem04 id3 and the Active Tag by using the MenuItem04 tag3
  • Title: MenuItem04 title4. Define the link by using the MenuItem04 id4 and the Active Tag by using the MenuItem04 tag4
Check Root Level Configuration for more info.
Define the text for the sixth Menu Item Parent. Check Root Level Configuration for more info.
The Fifth Menu Item retreives the four latest posts of the Type you will define. You can type anything from "text", "photo", "quote", "link", "chat", "audio", "video" or "answer". Check Menu Item 05 for more info.
Define the text for the Last (seventh) Menu Item Parent. Check Root Level Configuration for more info.
The Sixth Menu Item retreives the four latest posts that contain the tag you define here. Check Menu Item 06 for more info.
Disqus Set up the commenting system on the posts permalink pages Check "Disqus Integration" for more info.
Mailchimp username You need to configure the mailchimp username for the Newsletter field to show up on the footer. Check "Mailchimp Integration" for more info.
Mailchimp DC You need to configure the mailchimp DC for the Newsletter field to show up on the footer. Check "Mailchimp Integration" for more info.
Mailchimp userHash You need to configure the mailchimp userHash for the Newsletter field to show up on the footer. Check "Mailchimp Integration" for more info.
Mailchimp ID You need to configure the mailchimp username for the Newsletter field to show up on the footer. Check "Mailchimp Integration" for more info.
Facebook Fill this with the URL of your Facebook page, to have a link shown on the footer. Check "Social Share Buttons" for more info.
Instagram Fill this with the URL of your Instagram page, to have a link shown on the footer. Check "Social Share Buttons" for more info.
Pinterest Fill this with the URL of your Pinterest page, to have a link shown on the footer. Check "Social Share Buttons" for more info.
Twitter Fill this with the URL of your Twitter page, to have a link shown on the footer. Check "Social Share Buttons" for more info.
Etsy Fill this with the URL of your Etsy store, to have a link shown on the footer. Check "Social Share Buttons" for more info.
Vendors Source Define the path for the Vendors Source.Leave unchanged for making sure you ALWAYS have the latest version! Check "Uploading the Vendors Javascript file" for more info. http://feddyups.github.io/angularized/angularized_vendors.js
CSS Source Define the path for the CSS Source.Leave unchanged for making sure you ALWAYS have the latest version! Check "Installing the CSS source" for more info. http://feddyups.github.io/angularized/angularized.css
Core Source Define the path for the Core Source.Leave unchanged for making sure you ALWAYS have the latest version! Check "Installing the Core Javascript source" for more info. http://feddyups.github.io/angularized/angularized.js

Changelog

19.06.2016 - v1.0

Initial Release

Rating the Theme

It would be awesome if you could rate the theme for me. If you feel the theme deserves less than 5 stars please contact me before rating and I will try to improve your experience with the theme.


Need some extra help?

If you need a helping hand or would like to customise the theme then shoot me an email at feddyups@gmail.com

Scroll To Top