Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Template usage is undocumented #28

Open
JOJ0 opened this issue Dec 28, 2020 · 1 comment
Open

Template usage is undocumented #28

JOJ0 opened this issue Dec 28, 2020 · 1 comment

Comments

@JOJ0
Copy link
Contributor

JOJ0 commented Dec 28, 2020

Hi, I had a hard time trying to figure out how to use wagtailnews in templates. I had to use template debugging tools to finally find out that these variables are mainly to be used:

newsitem_list
newsitem_page
newsitem_view

newsitem_list can be iterated through to receive a list of news pages / blog posts. That was the most important thing for me to find out by experimenting.

I am a wagtail beginner more or less, so please point me in the right direction if this would have been found somewhere in the docs or could be otherwise retrieved by reading code - In any case, mentioning it at least in you README.md is essential, at least to my understanding.

Thanks a lot for wagtailnews! :-)
and all the best,
Jojo

@seb-b
Copy link
Member

seb-b commented Jan 4, 2021

Fair call, some extra documentation would help peolpe find that info, at the moment you could only find that out by looking at the source.

I think the best place would be under 'Usage' in the docs with a bit of info about how to setup your templates for use with wagtailnews. Thanks for pointing this out 👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants