The Arcive of Official vBulletin Modifications Site.

Commbull (Community Bulletin) 5.1a for vBulletin 4.01 · **Released**: 01-21-2010

This not the CommBull product itself. This is simply instructions for adapting it to work with vBulletin 4.x.

Download CommBull from: Commbull (Community Bulletin) 5.1a for vBulletin 3.8x

grandeur_69 has released his latest version of CommBull as a free add-on, indicating that he no longer has time to continue developing it. I am posting this here for the benefit of other vBulletin 4.x who don't want to lose the newsletter feature (grandeur_69 has approved this).

At https://vborg.vbsupport.ru/showpost....6&postcount=71 a member asks:

Quote:

Hi, the version 5.1a work fine with vbulletin 4.0.1 ?

My response is posted at https://vborg.vbsupport.ru/showpost....5&postcount=72 and reproduced here...

I have the previous (commercial) version, 4.5f, which does run successfully via a cron job, running on 4.01. It required some modification of the installation instructions but it does work. I expect you should be able to get this version running as well, although as the coder noted the cron capability won't work.

1. Edit product-Commbull.xml and find the following line:

PHP Code:


			
        <dependency dependencytype="vbulletin" minversion="3.6.0" maxversion="3.8.99" />

Change to:

PHP Code:


			
        <dependency dependencytype="vbulletin" minversion="3.6.0" maxversion="4.99" />

2. Upload the files and import the product.

3. Now you need to do the template edits so that members can opt-in or opt-out of your newsletter. The current instructions are as follows:

Quote:

4. Template modifications
--------------------------------------

Template: "Modify User Option" -> "modifyoptions"

After:

PHP Code:


			
                    <tr>

                        <td><label for="cb_adminemail"><input type="checkbox" name="options[adminemail]" value="1" id="cb_adminemail" $checked[adminemail] />$vbphrase[receive_email_from_bulletin_board_staff]</label><input type="hidden" name="set_options[adminemail]" value="1" /></td>

                    </tr>

Add:

PHP Code:


			
                    <tr>

                        <td><label for="commbull"><input type="checkbox" name="commbull" value="1" id="commbull" $checked[receivebulletin] />$vbphrase[receive_email_from_commbull]</label><input type="hidden" name="set_options[receivebulletin]" value="1" /></td>

                    </tr>

                    <tr>

                        <td><br />$vbphrase[newsletterformat]<br /><label for="commbull_type"><input type="checkbox" name="commbull_type" value="1" id="commbull_type" $checked[receivebulletin_type] />$vbphrase[type_email_from_commbull]</label>

<input type="hidden" name="set_options[receivebulletin_type]" value="1" /></td>

                    </tr>

Now, obviously this won't work in 4.x. These need to be modified as follows:

1. Edit Template: "Modify User Option" -> "modifyoptions"

FIND:

PHP Code:


			
<vb:if condition="$show['friend_email_request']">

                    <li>

                        <label for="cb_receivefriendemailrequest"><input type="checkbox" name="options[receivefriendemailrequest]" value="1" id="cb_receivefriendemailrequest" tabindex="1" {vb:raw checked.receivefriendemailrequest} /> {vb:rawphrase receive_friendship_req_email}</label>

                        <input type="hidden" name="set_options[receivefriendemailrequest]" value="1" />

                    </li>

                </vb:if>

ADD AFTER:

PHP Code:


			
<vb:if condition="$show['receiveemail']">

<li>

    <label for="commbull"><input type="checkbox" name="commbull" value="1" id="commbull" tabindex="1" {vb:raw checked.receivebulletin} />{vb:rawphrase receive_email_from_commbull}</label>

    <input type="hidden" name="set_options[receivebulletin]" value="1" />

</li>

</vb:if>

That first part (above) is the option to receive or not receive the newsletters.

Next would be the option for HTML or plain text emails, which should be:

PHP Code:


			
<vb:if condition="$show['receiveemail']">

<li>

    <label for="commbull_type"><input type="checkbox" name="commbull_type" value="1" id="commbull_type" tabindex="1" {vb:raw checked.receivebulletin_type} />{vb:rawphrase type_email_from_commbull}</label>

    <input type="hidden" name="set_options[receivebulletin_type]" value="1" />

</li>

</vb:if>

Update:

This now works. I had a ( instead of a { on the previous code. Thanks to grandeur_69 for pointing this out!

Notes:

The product is not mine so I can't offer any support for CommBull itself. However, I have been using the paid versions of this mod for some time and I'm happy to offer what support I can for making the changes necessary to get it running on 4.x.
I have been in communication with grandeur_69. He has indicated that he has no objections to this thread and that as he gets time he will be trying to develop this add-on further as a free product.

Update July 12, 2010: Product XML file provided by grandeur_69 for vBulletin 4.x.

NOTE:

If you have already done the manual edits, do NOT use the XML file. And if you import the XML file, you should not need to do the manual edits.
Some people are encountering problems using the XML file. If you are one of them, uninstall the product and use the manual edits. Those seem to work just fine.

Update July 14, 2010: Error in XML file corrected.

ArchAngelz · #32 06-06-2010, 04:02 AM

Quote:

Originally Posted by djbaxter

I have the previous (commercial) version, 4.5f, which does run successfully via a cron job, running on 4.01. It required some modification of the installation instructions but it does work. I expect you should be able to get this version running as well, although as the coder noted the cron capability won't work.

Can you share how the installation instructions should be modified in order to get v4.5 working? It seems that v4.5 may be better than v5.1 and hence, installation instructions for that may be useful.

djbaxter · #33 06-06-2010, 08:25 PM

Quote:

Originally Posted by ArchAngelz

Can you share how the installation instructions should be modified in order to get v4.5 working? It seems that v4.5 may be better than v5.1 and hence, installation instructions for that may be useful.

The modifications above are for 4.5f but shouild work with 5.1.

If you are asking how to install 4.5f, if you have a copy, those versions require either the Zend Optimizer or Ioncube installed on youjr server.

The installations instructions for 4.5f are as follows (from the ReadMe):

Quote:

ENCODED FILES
=============
The files in these packages are encrypted to protect the code. You will need to install Zend Optimizer (zend.com) or IonCube (ioncube.com) to make the files work.

INSTALL:
======

1. Add Commbull XML Product Plugin
----------------------------------------------

- Go to your ACP and select "Plugin System -> Manage Products".
- Click "[Add/Import Product]".
- Navagate to the "commbull-product.xml" file included with this installation file and click "Open".
- Then click "Import".

2. File Upload
-------------------------------------
- upload all the files in either the upload-IonCube or upload-Zend folders in Binary Mode, depending one which optimizer you have installed. Do not upload the folder itself, but only it's contents to the forum root. I did not make any changes to any of the vB files, so you don't have to worry about any of them being overwritten.

IN BINARY MODE:
---- if you do not upload the files in Binary mode, you will get something that looks like:
Fatal error: Unable to read 42220 bytes in /site/root/forums/admincp/commbull.php on line 0

3. Cronjob
-------------

- A default cron (Sunday at 4am) was added when you imported the Plugin, however it is disabled by default.
- Go into "Scheduled Tasks" -> "Scheduled Task Manager" and edit "commbull_newsletter_send_task" to the desired schedule.

**NOTE: before the cron can run properly, you must "save" the settings necessary to run it on it's own. To do that, you will need to partially start the first run. Go to ./admincp/commbull.php and change all the necessary settings that you wish to run and be sure to select "Save Preferances" near the bottom, otherwise it won't have anything
to run and the cron will fail. If you view the cronlog, and it failed, you will see "Commbull [No Settings Defined! - quitting]".

docvader · #34 06-13-2010, 12:04 AM

Getting back to this unsubscribe issue, the mailer points to an unsubscribe link of:

http://forum.russbo.com/admincp/$commbull_unsubscribe

$commbull_unsubscribe doesn't work. Any idea as to what to change that PHP line to, to make it work appropriately?

This seems to get you to the edit options page, but I wasn't sure if there was a commbull specific link

Code:

 <a href="http://mysite.com/profile.php?do=editoptions\">\$vbphrase[tounsubscribe]</a>

djbaxter · #35 06-13-2010, 01:22 AM

No, that's it. If you've followed directions, that should take the member to options where s/he can uncheck the "receive commbull newsletters" option.

djbaxter · #36 07-12-2010, 03:22 PM

Update July 12, 2010: Product XML file provided by grandeur_69 for vBulletin 4.x.

Dragonsys · #37 07-13-2010, 07:49 PM

When someone checks (or unchecks) the boxes in their Options, the settings are not saved in the DB. Everything else is working perfectly.

djbaxter · #38 07-14-2010, 12:16 AM

Quote:

Originally Posted by Dragonsys

When someone checks (or unchecks) the boxes in their Options, the settings are not saved in the DB. Everything else is working perfectly.

It's working for me.

Make sure the member knows to scroll down to the bottom of the page and click on "Save".

One other possibility is that if it's an admin who is configured as "unalterable" in config.php, I'm not sure whether that will be saved.

Added: Are you talking about the manual edits or the XML file?

Dragonsys · #39 07-14-2010, 01:38 AM

Quote:

Originally Posted by djbaxter

It's working for me.

Make sure the member knows to scroll down to the bottom of the page and click on "Save".

One other possibility is that if it's an admin who is configured as "unalterable" in config.php, I'm not sure whether that will be saved.

Added: Are you talking about the manual edits or the XML file?

The manual edits, to modifyoptions. I used the latest xml file you uploaded yesterday.
I was trying it in my settings. I have checked and I am an admin, but I am not unalterable, in config.php.

I changed my settings via a SQL cmd. then I went into my settings and unchecked the HTML Type. When I hit save, it blanked both boxes. The only way I can get it to set back to enabled, is by using a SQL cmd.

djbaxter · #40 07-14-2010, 01:53 AM

What vBulletin version are you using?

Dragonsys · #41 07-14-2010, 02:41 AM

Quote:

Originally Posted by djbaxter

What vBulletin version are you using?

4.0.4 PL1

Looking at the xml file, I do see this:

Code:

	<templateedits>
		<templateedit template="modifyoptions" varname="modifyoptions_commbull" username="Commbull" version="5.3" dateline="1278487345" searchorder="5" active="1" product="Commbull">
			<title><![CDATA[Community Bulletin]]></title>
			<searchstr><![CDATA[						<input type="hidden" name="set_options[adminemail]" value="1" />
					</li>]]></searchstr>
			<replacestr><![CDATA[						<input type="hidden" name="set_options[adminemail]" value="1" />
					</li>
<li>
    <label for="receivebulletin"><input type="checkbox" name="receivebulletin" value="1" id="receivebulletin" tabindex="1" {vb:raw checked.receivebulletin} /> {vb:rawphrase receive_email_from_commbull}</label>
    <input type="hidden" name="set_options[receivebulletin]" value="1" />
</li>

<li>
    <label for="receivebulletin_type"><input type="checkbox" name="receivebulletin_type" value="1" id="receivebulletin_type" tabindex="1" {vb:raw checked.receivebulletin_type} /> {vb:rawphrase type_email_from_commbull}</label>
    <input type="hidden" name="set_options[receivebulletin_type]" value="1" />
</li>
]]></replacestr>
      </templateedit>
	</templateedits>

I wonder if my manual edits are conflicting with the edits inside the xml file.

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.07784 seconds Memory Usage 2,400KB Queries Executed 26 (?)
More Information
Template Usage: (1)SHOWTHREAD (1)ad_footer_end (1)ad_footer_start (1)ad_header_end (1)ad_header_logo (1)ad_navbar_below (1)ad_showthread_beforeqr (2)bbcode_code (7)bbcode_php (8)bbcode_quote (1)footer (1)forumjump (1)forumrules (1)gobutton (1)header (1)headinclude (1)modsystem_post (1)navbar (4)navbar_link (120)option (1)pagenav (1)pagenav_curpage (4)pagenav_pagelink (1)pagenav_pagelinkrel (11)post_thanks_box (11)post_thanks_button (1)post_thanks_javascript (1)post_thanks_navbar_search (11)post_thanks_postbit_info (10)postbit (4)postbit_attachment (11)postbit_onlinestatus (11)postbit_wrapper (1)spacer_close (1)spacer_open (1)tagbit_wrapper Phrase Groups Available: global inlinemod postbit posting reputationlevel showthread	Included Files: ./showthread.php ./global.php ./includes/init.php ./includes/class_core.php ./includes/config.php ./includes/functions.php ./includes/class_hook.php ./includes/modsystem_functions.php ./includes/functions_bigthree.php ./includes/class_postbit.php ./includes/class_bbcode.php ./includes/functions_reputation.php ./includes/functions_post_thanks.php Hooks Called: init_startup init_startup_session_setup_start init_startup_session_setup_complete cache_permissions fetch_threadinfo_query fetch_threadinfo fetch_foruminfo style_fetch cache_templates global_start parse_templates global_setup_complete showthread_start showthread_getinfo forumjump showthread_post_start showthread_query_postids showthread_query bbcode_fetch_tags bbcode_create showthread_postbit_create postbit_factory postbit_display_start post_thanks_function_post_thanks_off_start post_thanks_function_post_thanks_off_end post_thanks_function_fetch_thanks_start post_thanks_function_fetch_thanks_end post_thanks_function_thanked_already_start post_thanks_function_thanked_already_end fetch_musername postbit_imicons bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete postbit_attachment postbit_display_complete post_thanks_function_can_thank_this_post_start pagenav_page pagenav_complete tag_fetchbit_complete forumrules navbits navbits_complete showthread_complete
Messages:

The Arcive of Official vBulletin Modifications Site.

It is not a VB3 engine, just a parsed copy!