My favorites | Sign in
Project Logo
                
Search
for
Updated Mar 21, 2007 by Tiago.Pocinho
Labels: Featured, Phase-Deploy
Instructions  
Installation and Configuration instructions

Installation

After downloading this plugin, extract the directory "wp-ajax-newsletter".

Go to the Wordpress back-office and activate the plugin. This will create the needed tables in the database.

Newsletter Subcription Form

To add the subscription form in your template, insert the following code where you want the form to appear:

<?php if (class_exists('ajaxNewsletter')): ?>
<!-- place your HTML code here -->
<?php ajaxNewsletter::newsletterForm(); ?>
<!-- place your HTML code here -->
<?php endif; ?>

Note: The <!-- place your HTML code here --> instruction is optional. You can use it to add a title or a container. An example for the default Wordpress template is:

<?php if (class_exists('ajaxNewsletter')): ?>
<li><h2>Newsletter</h2>
   <div style="padding:5px 3px;">
      <?php ajaxNewsletter::newsletterForm(); ?>
   </div>
</li>
<?php endif; ?>

Styling the Form

You can use the following CSS classes to style the form in the front-office:

#ajaxNewsletter, .newsletterContainer {
	/* newsletter container */
}

#newsletterFormDiv {
	/* newsletter form elements*/
}

.newsletterTextInput {
	/* email text input */
}

#newsletterLoading {
	/* the loading message while the subscription is being handled */
}

.success {
	/* the success message container */
}

.error {
	/* the error message container */
}

For example, to get a similar result as shown in the demonstration video, add the following code to your template CSS file:

.newsletterTextInput{ width:120px; }

.newsletterContainer{ width:100%; }

.success {
	background: #CFEBF7;
	border: 1px solid #2580B2;
}

.error {
	background: #FFEFF7;
	border: 1px solid #c69;
}

.error, .success {
	margin: 3px 0px;
	padding: 2px;
}

Configuration

To configure this plugin access "Newsletter" under the "Options" tab.

The following tags can be used in the template for the newsletter:

{TITLE} The post title
{URL} The post URL
{DATE} The date when the post was published (uses Wordpress defined format)
{TIME} The time when the post was published (uses Wordpress defined format)
{AUTHOR} The post author
{EXCERPT} The post excerpt. If none is available, it will be generated based on the content.
{CONTENT} The post content.


Comment by fili...@caggiani.it, Jul 28, 2007

Hi! I have some questions: isn't it possible to use html in the header? Moreover, my posts are written using an Italian keyboard, so the newsletter has the excerpts with wrong accents. Can you suggest me any solution? Thank you. Your plugin is great! Filippo

Comment by funand, Aug 22, 2007

This is best newsletter plugin I've found for WordPress? and the Ajax at sign-up makes it the most classy. My only regret is the absence of the posts permalink. Perhaps in a future version? Thanks again, Andy

Comment by sinaevil, Aug 29, 2007

hi i always see this error when want new member join An error occured. Please try again later

what is the problem. i just can add one address without error

Comment by fmp.misi, Sep 04, 2007

I cannot update new settings on the Options page... I dunno why don't update MySQL settings...

Comment by fmp.misi, Sep 04, 2007

After all - I could, just after i push the "Update" button 5 times :P!

Comment by mscave, Sep 16, 2007

Yeah I'm having the same problem with the update's not working correctly. I have to hit the update button several times for it to stick.

This is a great simple newsletter plug-in that I've been looking for so an update for this would be huge! Thanks!

Comment by mscave, Sep 16, 2007

Yeah I'm having the same problem with the update's not working correctly. I have to hit the update button several times for it to stick.

This is a great simple newsletter plug-in that I've been looking for so an update for this would be huge! Thanks!

Comment by ladyzebra, Sep 24, 2007

is it possible to put the form in a widget? how can i do this?

Comment by ladyzebra, Sep 24, 2007

is it possible to put the form in a widget? how can i do this?

Comment by ladyzebra, Sep 24, 2007

is it possible to put the form in a widget?

Comment by tdenski, Oct 06, 2007

I don't know what it means to go to the wordpress back-office and activate it.

Comment by giulio.cisamolo, Oct 11, 2007

1. to put the code into a widget, you go to activate another plugin - you can find it easily - that permit you to run php code into widgets. 2. "to go to the wordpress back-office and activate it" means: go to the place were you write posts, choose the voice "plugins", and activate it. but probably if you don't know what the backoffice is you would'nt be able to run the plugin.

Cheers.

Comment by i...@fibraopticahoy.com, Oct 31, 2007

and it is possible to use my templates to send the post???? and uses images??? thanks

Comment by rakanowicz, Nov 09, 2007

Is there a way to to a redirect after a user enters his email address? That would be helpful for tracking conversion campaigns.

Comment by vincent.keunen, Nov 18, 2007

It took me some time to install the plugin because I don't know PHP and I don't know the internals of Wordpress. To easily install this plugin, first install the plugin/widget ExecPHP (from http://ottodestruct.com/blog/2006/04/09/fun-with-widgets/) then paste the PHP code mentionned above into the ExecPHP code...

Good luck

Comment by spacelord.scott, Nov 26, 2007

I see that Update does actually work, but the page doesn't display the updated information! Perhaps the data is being pre-loaded before the update is actually being performed? In any case, simply clicking in the address bar and hitting return (i.e., reloading the form) shows the proper info.

Comment by vincent.keunen, Nov 29, 2007

I've been trying long and can't get it to work!... It's installed, but no changes are saved (even when trying multiple times and when reloading the page, etc...). My version of WP is 2.3.1, French. Could it be the problem? Or a DB or FW problem? How can I debug?

Thanks for any help

Comment by vincent.keunen, Nov 29, 2007

I even tried to use IE :-( to see if the problem was related to FF, but none of them works... My WP is hosted on a computer I can manage (I have access to the DB, file system, etc...).

Comment by vincent.keunen, Nov 29, 2007

OK I solved the problem... It's the French version of the newsletter that does not work... Installing the EN version (even on a FR WP) works... Thanks. I'll notify http://www.wordpress-fr.net (where I found the Fr version of this plugin)

Comment by asonguide, Dec 04, 2007

I am unable to send out the newsletter manually. The "number of posts" field is deactivated, so I can't change the "0" to any given number. What shall I do?

Comment by ge...@restolho.com, Dec 08, 2007

i have this fatal error:

Fatal error: Call to undefined function: activatesubscriber() in /home/logos/public_html/wp-content/plugins/wp-ajax-newsletter/confirmation.php on line 39

/////// confirmation.php ///////7

Line 39: ajaxNewsletter::activateSubscriber($id);

any sugest?

Comment by steve806, Jan 04, 2008

I think the plugin is what I am looking for but I get this error message....any ideas?

WordPress? database error: 'v6buick_wrdp4.wp_snews_members' doesn't exist? SELECT state FROM wp_snews_members WHERE email = 'v6buick@bestgrapeseedextract.com'

WordPress? database error: 'v6buick_wrdp4.wp_snews_members' doesn't exist? SELECT COUNT() FROM wp_snews_members WHERE user = 1;

Comment by hendra64, Jan 09, 2008

Great plugin. Thanks.

I'm waiting for a new release, especially for newer wordpress version (2.3.1 and 2.3.2). Thanks again.

Comment by asket...@gmx.net, Jan 10, 2008
Comment by asonguide, Dec 04, 2007

I am unable to send out the newsletter manually. The "number of posts" field is deactivated, so I can't change the "0" to any given number. What shall I do?


I have the same problem...what should i do? cant send the newsletter atomatically and cant send manually....problem with mysql or what??

Comment by davemcLane, Jan 10, 2008

I installed the plugin in the sidebar of my Wordpress 2.3.2. The 'subscribe' box appears OK with my e-mail address but when I click on 'subscribe' the 'subscribe' botton drops down and a faint, barely readable message appears saying "MOVED PERMANENTLY". Probably to do with the fact that I'm running 2.3.2 and the documentation says 2.0x or 2.1.

What can I do to fix this?

Comment by espmartin, Feb 21, 2008

The "non-update" thingie is very annoying. Also, "Periodicity" does NOT stay where I set it to. It always goes back to "Manual" - but I want it set to: "Every 5 Posts".

Are there fixes for these issues?

Comment by michael.tingle, Mar 02, 2008

when the send button is greyed out you need to make a fresh post, then the send and number of posts will be available again. At least this worked for me -Mike

Comment by colorproof, Mar 25, 2008

Has anyone been able to modify this plugin so it can send HTML newsletters rather than plain text?

Comment by jaromero, Mar 26, 2008

I have installed and activate the plugin but no mail are sent. When I subscribe, the confirmation mail is not sent. Thank you in advance

Comment by AdrianusV, Apr 04, 2008

Yesterday I updated WP-Ajax-Newsletter (v1.0), because I noticed that my weekly newsletters were not send since december '07. Oops, can happen. But today I noticed that the newsletter was send more than 20 times! In the options menu the frequency was set to one newsletter a week! What's causing this avalanche of newsletters?

Comment by idewwebs, Apr 05, 2008

I installed the plugin and activated it, but no form appears. I have the code in a text box, is that the problem? I put some text right after it checks for the class and the text appears, but no form.

Comment by idewwebs, Apr 05, 2008

Update: That does appear to be the problem; you have to put the code directly into the sidebar file. But I noticed also that I cannot change the number in the box for "send only the last nnn posts". This choice does not appear at all in IE6 but does in Firefox and Safari; you just can't change it. And IE shows different text under Send Newsletter than the other browsers.

Comment by mathieu_...@yahoo.fr, Apr 15, 2008

It doesnt work !!! Warning: newsletterconfig(backoffice.php) function.newsletterconfig?: failed to open stream: No such file or directory in /mnt/137/sdb/f/2/mathieu.lambert1/wp-content/plugins/wp-ajax-newsletter.php on line 200

Warning: newsletterconfig() function.include?: Failed opening 'backoffice.php' for inclusion (include_path='/mnt/137/sdb/f/2/mathieu.lambert1/include:.:/usr/php4/lib/php') in /mnt/137/sdb/f/2/mathieu.lambert1/wp-content/plugins/wp-ajax-newsletter.php on line 200

Comment by guitarrista, Apr 22, 2008

mmm... Mathieu, it seems you put the plugin's files directly in the plugins dir. You should put the folder wp-ajax-newsletter in the plugins dir, so that wp-ajax-newsletter.php file path is wp-content/plugins/wp-ajax-newsletter/wp-ajax-newsletter.php

Comment by farbror77, May 05, 2008

Great plugin. But I have the same problem as AdrianusV on Apr 5, and get lots and lots of copies of the newsletter.

Could it be, with a community blog, that every time someone logs in to his/her back office, another copy of the newsletter is sent to everyone on the list?

Comment by ad...@uncensored.co.nz, Jun 15, 2008

How do i put a space between each post?

At the moment there is no space between the URL and the next headine

Comment by sis.dcms, Jun 26, 2008

i am using wp 2.5.1 i installed wp-ajax-newsletter (lets call it wpnl) and i dont receive confirmation mails. i saw that wpnl is using @mail (php pbuiltin mail) function to send mails. i dont know how to configure this so i installed wp-mail-smtp plugin which allows wp to send mail directly to a smtp server. this is working for others plugins and wp core functions as registering users...

this plugin uses @wp_mail function instead of @mail so i tried to patch wpan code by changing the call to @mail by @wp_mail in the sendEmail function. (it uses the same params) but it doesnt seem to work.

are you planning on releasing new version for wp 2.5.1? can you give a look at that fonctionallity (allowing to send mails directly to a smtp server - ie do not use bilt in mail php function) thanx a lot

Comment by furtheronline, Jul 14, 2008

I keep getting a newsletter every time the homepage is refreshed! How do I stop that?

Comment by cezary.tomczyk, Jul 22, 2008

After installing the plugin can not subscribe to any user, because the bug is still "Invalid email address: undefined", but making the correct address. Can You fix it?

Comment by redocs, Oct 08, 2008

how can i reset the count of the post ? i have new subscriber and i want to re-send the newsletter but i can't

Comment by sksunil, Jan 06, 2009

This plugin looks very good. But the page is not xhtml valid :(

Comment by matteoraggi, Mar 02, 2009

I'll be glad to translate your script in italian language, in change to receive a link to one of my sites from your site page, for example from http://www.ebabysitter.info it could be?

Comment by gugomeil, Mar 09, 2009

Is it possible to manage the subscribers manually? I need to add manually some email addresses, but I don't know if it's possible. Someone can help me? Thanks

Comment by bdpetey, Mar 20, 2009

fantastic plugin!!! thank you. one issue i'm having... some of my subscribers are actually receiving two email notifications (including myself). but it doesn't seem like everyone is. any recommendations of what the problem might be and how i could resolve it? thank you.

Comment by 22nexpress, Apr 14, 2009

Hats up to the Author...

At last i got the plugin that I want.

Thanks a lot..

Chinmay Chiranjeeb http://www.chiranjeeb.com

Comment by hamza.inout, Jul 15, 2009

Hi can i add post title in email subject ??

Comment by dukessa.regs, Aug 15, 2009

I have the same problem as someone else, when I try to subscribe from my homepage, where I used the code you provided, I always get INVALID EMAIL ADDRESS: UNDEFINED I'm using WP 2.8.3. This is the function that controls new subscriptions:

function subscribe($email){
		$returnVal = array();
		/* switch to this If if you wish to support emails@localhost as a valid email address*/
		//if(!eregi("^[_a-z0-9-]+(\.[_a-z0-9-]+)*@[a-z0-9-]+(\.[a-z0-9-]+)*(\.[a-z]{2,3})*$", $email)){
		if(!eregi("^[_a-z0-9-]+(\.[_a-z0-9-]+)*@[a-z0-9-]+(\.[a-z0-9-]+)*(\.[a-z]{2,4})$", $email)){
			$returnVal['result']=false;
			$returnVal['message']="Invalid email address.";
			return $returnVal;
		}

Any suggestions?? Please I cant use this plugin if this doesnt get solved :(

Comment by gustavobuarque, Sep 11, 2009

Hi the news are sent with problem in accentuation. I try change UTF-8 or ISO-8859-1. But don´t work. Can you help me?

Thanks

Gustavo Brazil

Comment by cavalini, Sep 22, 2009

Hi! I'm having a problem. When I try to send a news, this message shows This web page is not available. I did a test and subscribed a new e-mail and this e-mail does not reveive the news, but other e-mail that is in top of list receives. What can I do?

Comment by yves.darmangeat, Oct 09, 2009

I've the same problem as dukessa.regs... I use WP 2.8.3 also.. this issue is due to the "@" transformed into à "%40" which is the char-value of "@". this problem appears with Firefox or IE in same way. I verified encoding otion : utf-8 for the text editor and the blog... I use an identical french translation version. I don't understand why many people can use actually this plugin with WP. I suppose it concern the environment (variables, or system.. ?) Thank's for your help Sincerely YD

Comment by wends.ang, Nov 02, 2009

it chooses email addresses. for one particular email, the system always returns An error occured. Please try again later. Does it send something like a test mail to validate an email address? the one that gets an error is a valid email address though.

thanks, Wendy http://www.myoptimind.com


Sign in to add a comment
Hosted by Google Code