[EPIC] Theme Helpers

[JohnONolan]

This is an epic issue for all the theme helper issues in Milestone 0.3. It is assigned to me because it's purely here for keeping track of the individual issues. I will probably keep adding to it and I doubt it will be closed until 0.3 is complete.

Remove helpers

• {{nav}} - Not ready for this yet ~~Remove the {{nav}} helper #626 ~~

Name change requests #381

• {{dateFormat}} => {{date}}

Would also like an option to return date in format: 12 Aug 2013

• {{paginate}} => {{pagination}}

New helper requests

Globals #172

• {{@blog.title}}
• {{@blog.description}}
• {{@blog.url}} - The base url of the blog
• {{@blog.logo}}
• {{@blog.cover}} - Blog cover image
• {{@blog.themedir}} - Url of the active theme directory

Post Data #528

• {{url}} - The permalink

Next Post (Punted to 0.4)

• {{nextpost}} - Queries Ghost for the next newest post after the current one. If no newer post exists, it returns the next oldest post after the current one.

Previous Post

• {{previouspost}} - Queries Ghost for the next oldest post after the current one. If no older post exists, it returns the next newest post after the current one.

Author Data #358

• {{author.name}} - Returns user's firstname+lastname (this is .full_name for now)
• {{author.email}}
• {{author.url}} - URL field from user settings
• {{author.image}} - Profile picture
• {{author.cover}} - Cover image
• {{author.bio}}
• {{author.profile}} - URL to user's public profile / list of posts

Tags #369

• {{tags}} - Should put both tags, as well as link to tag archives

Header / Footer for scripts / styles #382

• {{ghost_header}}
• {{ghost_footer}}

Class lists #472

• {{body_class}} - Handy classes on the body tag
• {{post_class}} - Handy classes on the post container tag

Excerpt #471

• sanitise {{content}} / {{excerpt}}

[cgiffard]

I'll attack the author data part, since it overlaps with my current issue #358. If I get that finished I might have a stab at the rest.

[ErisDS]

This is an epic... I've updated it to make that a little clearer, but we haven't finished opening all these issues yet ;)

[ErisDS]

@JohnONolan What is the expected behaviour / output of {{url}}, {{nextpost}} and {{previouspost}} ? An absolute URL? A relative URL? A pre-populated anchor tag?

[JohnONolan]

What is the expected behaviour / output of {{url}}, {{nextpost}} and {{previouspost}} ? An absolute URL? A relative URL? A pre-populated anchor tag?

An absolute url

[ErisDS]

Soooo close!

[JohnONolan]

🎈 ❕

[ErisDS]

{{author.image}} - Profile picture

{{author.cover}} - Cover image

These are currently available but are

{{author.profile_picture}} and {{author.cover_picture}}

Would you like them 1) aliased from the model or 2) changed on the model (i.e. in #632)?

[JohnONolan]

Yeah, modal to 'image' and 'cover' then I think

[ErisDS]

shall I also change email_address to email? It's just email in settings so I think it is a very good idea.

[JohnONolan]

👍

[ErisDS]

Aliases are in place for {{author.image}} and {{author.cover}}.

Slug/Profile doesn't exist yet, also it's worth noting that the {{url}} helper would be expected to provide the correct url in the author context.. it clashes with the authors provided URL at the moment but this will be fixed. Thus if we added {{author.profile}} it would do the same thing as {{url}}?

[ErisDS]

Everything except user profile is done. user.profile or {{url}} should be done when profiles are added.