I haven't looked at newsletters functionality for a while and coming back to it after a few months I finding that's it's a little unclear what various parts are all about. Here's my first impression after not having looked at it for quite a long time:

Statistics: Clear and obvious, nothing needed here

Create/Send:
Clear what it does but not clear that you should look at other things first. E.g. Really you should look at the templates tab, specifically the "mail templates" and set that/those up as you want first.

Lists:
Lists is such a general term it's easy for someone to be confused here. Some text at the top of the page that says something like:

"Each of items in the list below will be a list that a subscriber can subscribe to." -- now see, list is being used for two different things and subscribe is being used twice so even trying to describe it is hard to remove potential confusion.

Perhaps rename the Tab to "Newsletters for Subscriber" or perhaps something more explanatory like:

"You can setup many types of newsletters for your subscribers. E.g. a "monthly" newsletter, a "Specials" and so on. Each one you create here will show up on the subscribers page as a newsletter that they can subscribe to. Also, when you send a newsletter out from the "Create/Send" tab you will see these type of newsletters in a dropdown box to select from."

Anyway, the idea being to make this clear as to what it's used for for the first time user. By no means is my wording all that great but anything is better than nothing and all as it takes is adding a markup field to the form.

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?

Add New List Form: Send Rate Field:
Does this do anything or is it just a reminder of what we intend to do?

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.

When I look around enough I'll figure out the answer (I knew it before as I did set it up and have it all working) to the above but this is my first impression looking through the tabs and of course that's what everyone is going to do first up.

Subscribers: Obvious and clear

Templates:
For me, by the time I got to this tab it was making sense but it probably should have some markup explaining that the templates here under "Mail Templates" will show up on a dropdown box under "Create/Send" just for the sake of completeness.

Settings: Obvious and clear to me

Files: 

Comments

Reg’s picture

I've been looking around and found under "Advanced Help" I can get to the readme and that explains some of the above (not all) however knowing how people work most won't go there, if they even have "Advanced Help" installed.

Reg’s picture

One more I am unsure of:

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?

Reg’s picture

Issue summary:View changes

typos

ParisLiakos’s picture

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

advernut’s picture

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.

ParisLiakos’s picture

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!

advernut’s picture

StatusFileSize
new25.92 KB

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.

ParisLiakos’s picture

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

advernut’s picture

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.

ShedPhotons’s picture

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.

ShedPhotons’s picture

Issue summary:View changes

Adding #3

geoo’s picture

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?