Add some documentation on the pages for clarification

Updated issue summary, adding #3

Add New List Form: Category Field:
What purpose does this have? Does this mean that when I newsletter is sent a node is created automatically for that newsletter and I can find it by searching for the tags put in here? Something else?

see #1281216: Allow categories for lists to understand the intention of category..essentialy it will be used some time in the future to allow having lists grouped in category.Eg see here http://www.ivillage.com/funnels/5

Add New List Form: Custom Send Rate Field:
I don't get this. What does "Once ____ nodes ....." The reason I don't get this is from what I can see of your module you don't use nodes. You create your own templates from which newsletters are sent. Now, even if you did create nodes, wouldn't there be one node per newsletter so why would you have a setting of "something nodes". A would appreciate some understanding here.

You can assign taxonomy terms to your templates, which feed the templates with nodes.eg If you chose weekly send rate the template will send the nodes that where published inside this week and belongs to the specified terms.I believe this one solves your send rate question as well:)

Newsletters are not only created in create/send tab...if you create recurring lists (Daily,Weekly,Monthly) those newsletters are being sent automatically if there are any published nodes of the template-attached terms, when cron runs.

I agree on the rest..I should update Readme file as well.And add those information under the Help page.
Also that help text when someone visits eg templates, would be awesome.It wouldnt require someone to do something more than navigate around the tabs to get the first grasp

Hi rootatwc,

First, I really like your Newsletter module and believe it's exactly what I need. I tried them all, short of using a third party solution (i.e. Constant Contact). I have installed the dev version for testing. While testing, I ran into a problem setting up and choosing the correct tokens in my monthly template.

My client needs to send out a monthly newsletter. The custom templates are set up and working great for the subscription sign-up process (Confirmation, Welcome and Unsubscribe). All tokens are working here.

Here's my problem, I have a multiple block template, each hopefully will feed in content from various nodes that have Taxonomy terms under vocabulary word "Newsletter" assigned to corresponding content types and nodes. When I go to pull or examine the Replacement Pattern Tokens, for the life of me, I can't figure out which tokens to select. I have tried using the basic "[node:Name]" and [node:summary], etc, but nothing seems to work (email is blank where the token is placed). The list of tokens is long and confusing. There are basic categories like Current date, Current page, Taxonomy, etc. Nodes, Newsletter, Newsletter list, Newsletter template is also in the list. Newsletter is even listed under Node. I think I'm close, but not quite there.

I have researched the issues for this module and I can see that it's relatively new and is under active development. When it's done I think it will be the Drupal standard.

Could you please tell me which tokens I should use?
Any help you could provide is greatly appreciated.

if your email is recurring, eg Monthly you should use [repeat] and [/repeat].
Check the Default template that comes with the module.:)
And thanks for your nice words!

I tried that, but it still didn't work for me. See attached screenshot of email. How do I test monthly newsletter templates? I also only want to load the teaser with a read more button linked back to the node. If I could just get one token to work I think I could figure the rest out.

Thanks again.

I dont think your newsletter is monthly..i think you created it from create/send tab?

Any chance i could check how have you set things up?if you could send me the username and password of a user with administer newsletter permission for your site,that would do it

Sorry for the delayed response - had to jump onto another project. I have tried everything I can think of, without success. I would send you login info if the site weren't live and belonging to a client.

The thing I don't understand is why the simple default template doesn't work either. Could you please explain how the node tokens are supposed to work? I have tried the following tokens and no luck: [node:title] [node:create] [node:summary]. [repeat] doesn't appear to be working either. I am sure the problem is on my end, but there doesn't appear to be a way to test it, other than from the create/send tab. Is there another way to test a template?

Thanks for any help you can provide.

The features list on the Newletter module home page includes "Custom template per list", which sounds like each distinct template can have different fields, and even its own stylesheet. But "Manage Fields" applies to all templates across the board, just as in SimpleNews, where all newsletters have the same fields. The "template" has a body tag, that, when filled out, becomes what one might call an "issue" rather than a template. Is it possible to have different field sets in different newsletters? If so, how can that be achieved? "Custom template per list" seems to mean that you can elect to send a given item to different subscriber lists, not that you can customize the templates for each newsletter.

I am guessing newsletters do not show up under the content tab because if you wanted to bulk e-mail a content type, you would create it, then paste it into a newsletter. Is that correct? Newsletter content doesn't appear under sitewide search results.

These things should be explained/clarified in the documentation.

Adding #3

Hi,
I try to add a new line in the text generated between [repeat] and [/repeat] but nothing works.
I tried this but still [node:body] text comes immediately after [node:created] in the received email:

[repeat] 
    <li><a href="[node:url]">[node:title]</a> - [node:created]<br />
        <br />
        <br />
        [node:body]<br />
    </li>
[/repeat] 

Is this normal?