PDA

View Full Version : Forum Subscription Indicator/Links on ForumHome

kyrnel
10 May 2004, 23:32
Description:

This hack will add an indicator to each Forum on ForumHome (and to subforums in ForumDisplay) that indicates whether the forum has been subscribed to.
The indicator can be clicked to Add/Remove the subscription to the forum.

Hack Overview:
Queries added: 0
Files to modify: 2 (1 if you have no subforums)
Templates to edit: 5
Phrases to add: 2
New Image files: 2

=========================================================
Instructions:

<file edits>

Step 1) Edit index.php
Find:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------


and replace with:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------



Step 2) Edit forumdisplay.php (only necessary if you have subforums)
Find:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------


and replace with:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------



<phrase additions>

Step 3) Add GLOBAL phrase
Varname: subscribed_click_to_unsubscribe
Text: Currently Subscribed - Click to REMOVE Subscription

Step 4) Add GLOBAL phrase
Varname: unsubscribed_click_to_subscribe
Text: Currently UNsubscribed - Click to ADD Subscription

<template edits>

Step 5) Edit FORUMDISPLAY (only necessary if you have subforums)
Find:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------


after it ADD:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------



Step 6) Edit FORUMHOME (4 changes)
(1)Find:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------


CHANGE it to:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------



(2)Find:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------


CHANGE it to:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------



(3)Find:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------


after it ADD:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------



(4)Find:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------


CHANGE it to:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------



Step 7) Edit forumhome_forumbit_level1_nopost
Find:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------


CHANGE to:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------



Step 8) Edit forumhome_forumbit_level1_post
Find:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------


after it ADD:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------



Step 9) Edit forumhome_forumbit_level2_post
Find:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------


after it ADD:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------



Step 10) Upload the image files (subscribe_new.gif and subscribed_new.gif) to the images/buttons folder.

That's it!
=========================================================

Screencap and images attached...
Enjoy :)
kyrnel
10 May 2004, 23:41
ARGHH! The Attachment Manager is not allowing me to upload GIFs and I can't link them from my site since I have hotlink protection enabled. So here is a ZIP file.

[Edit - I was able to upload a JPG of the screencap]
Boofo
10 May 2004, 23:43
Can you please make a text file for this so it will be easier to download and install? ;)

And can we use the words Subscribe and Unsubscribe for this instead of images?
kyrnel
10 May 2004, 23:45
Sure, sorry, this is my first real hack. :) Will upload shortly.
Boofo
10 May 2004, 23:46
I just edited my post. Can we use words instead of images for this (as in my post above)?
kyrnel
10 May 2004, 23:48
Certainly. That option would actually be much easier, since you dont really have to add a new column to the table.
Did you want a separate column, or just the text in the same cell as the Forum title?
Boofo
10 May 2004, 23:59
I just want to add it underneath the forumd escription on a separate line and have it say Subscribe or Unsubscribe and have it change accordingly when it is clicked. vB2 used to have a hack like this and it was great! ;)
kyrnel
11 May 2004, 01:09
OK, to JUST add a text link beneath the forum description, follow these steps:

1) Make file changes as indicated above (index.php and forumdisplay.php)
2) Edit forumhome_forumbit_level1_post
Find:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------


and CHANGE to:


Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------


3) Make the exact same change as above to forumhome_forumbit_level2_post.

This will basically make the forums look like they currently do in the UserCP with the 'Unsubscribe" link.

I'd like to get some feedback and see if I need to make any other changes before I finalize these two options and make the associated text files. :)
Boofo
11 May 2004, 01:26
Ok, I did like you said, and the subscribe link shows up but when I click on it and subscribe to a thread, it still says subscribe for the link. It doesn't change to unsubscribe.

Should it be saying subscribe on all of them, even the ones I am already subscribed to?
Boofo
11 May 2004, 01:30
This is the code I have for the indedx.php:



Code:
---------------
Code is only visible to licensed users, and only when logged into the forums.
---------------



It doesn't have a second number. Now if I add that second number, then it works like it should. But is that going to mess up the moderator cache that way?
kyrnel
11 May 2004, 02:09
You're right. The '0' wont change anything because the default value is 0 for that function.

I have updated the instructions. The next file edit was wrong as well, I fixed it too.
MrNase
11 May 2004, 06:22
Hey,

this could come in handy when i use subscriptions :)

thx
Boofo
11 May 2004, 07:05
You're right. The '0' wont change anything because the default value is 0 for that function.

I have updated the instructions. The next file edit was wrong as well, I fixed it too.
I don't see any difference in the forumdisplay.php file edit. It looks the same to me. ;)

Now this won't work with forums you are already subscribed to, right? Any way to run a query to set it up like that? ;)
kyrnel
11 May 2004, 14:28
It was the "Find:" code that was wrong for forumdisplay.php, not the replacement code.

Basically how it works is this:
When you pass the userid to the cache_ordered_forums() function it adds the field [subscribeforumid] to the query. If this field is populated with a value, then that means that you are subscribed to that forum. So it doesnt add any queries, but it makes an existing query slightly more complex.

So it will work with existing subscriptions. No need to update anything.
Boofo
11 May 2004, 17:25
Ahhh, ok, that makes more sense now. Thank you for the explanation. I was wondering how it worked. ;)
Boofo
11 May 2004, 18:22
Any way to make the links work in the Forum tools dropdown? ;)
kyrnel
11 May 2004, 18:28
That is a good question. I will have to look into that. I expect that it will require a different approach since the forum details in ForumDisplay (other than subforums) are not generated by the cache_ordered_forums function.

Actually, this has already been done in another hack, here:
http://www.vbulletin.org/forum/showthread.php?t=63373&highlight=unsubscribe+forum
Boofo
11 May 2004, 19:06
That is a good question. I will have to look into that. I expect that it will require a different approach since the forum details in ForumDisplay (other than subforums) are not generated by the cache_ordered_forums function.

Actually, this has already been done in another hack, here:
http://www.vbulletin.org/forum/showthread.php?t=63373&highlight=unsubscribe+forum

Thank you, sir. Apparently I had already clicked install in that thread but never installed it. Must have forgotten about it. ;)

Your hack works like a charm. Thank you, again. ;)
kyrnel
12 May 2004, 14:48
Well, if there are no more comments/questions, then I will go ahead and write this up as a full release.

There is actually little that can go wrong with this hack since it mostly utilizes the existing code in vB. I just wanted to make sure that my instructions were accurate.
Boofo
12 May 2004, 15:14
Accurate and excellent! ;)
InfoNirvana
03 Jun 2007, 20:37
I'd like this for 3.6