Help - Search - Members - Calendar
Full Version: IP.Converge Documentation
Invision Power Services > Invision Power Services, Inc. > IPS Company Feedback > IP.Converge
Lındsey
Now I know Documentation is in the IPB Documentation for converge but can we get some better Documentation on converge by anychance???
JasonIPS
What exactly do you mean by better? What is it that is missing that you need?
Lındsey
As far as I know the section is for devs on how to make IP.Converge ready products.
When I say Better i mean a full guide on how to setup Converge then how to converge the forums and anything else that converge uses. original.gif
Alεx
Am I missing a documentation, because I would like to know how to create converge applications.
.Ryan
There is documentation available from IP. Board that has some of the converge stuff but its particularly confusing to me. Maybe a sample example?
Tom T
QUOTE (Alεx @ Feb 26 2008, 03:16 PM) *
Am I missing a documentation, because I would like to know how to create converge applications.

I believe that info on that is included in the IP.Board Developer Docs
RainbowViper
I asked this on the main board as part of a larger question.

Yes, the Dev Docs contain advanced info.

What's needed for us IPB newbies is a PDF titled something like, "What is Converge, and how does it integrate it into my board?"....

Even a single HTML page with answers would be a start?

Thanks in advance.

bfarber
We're working on the docs. original.gif
RainbowViper
Thank you.

And in fairness to you, the Developer Documentation DOES appear to contain enough information for me. Not sure yet, as I still have a LOT of reading to do, but actually using it is going to take me a while.

I'm coming from IPB 1.3.1 !!!! wink.gif

M


Ahoekie
QUOTE (bfarber @ Mar 21 2008, 06:00 PM) *
We're working on the docs. original.gif


Do you have a date set when this will be available for public?
bfarber
I think a first draft is already ready internally, but I can't say when it will be released.
China J
QUOTE (JasonIPS @ Feb 26 2008, 09:45 AM) *
What exactly do you mean by better? What is it that is missing that you need?


How to create converge applications is not in the IPB developer docs... It merely only describes how the process works via some lingo and charts. Converge has been released for some time now and when people betch, moan and complain IMO I don't think the response should be "What else do you need?" Add some applications to the pool to get us started or something considering the IPB docs does not go into specific details or lead you by the hand on how to create your own applications. The only thing it does give you only is a "Scooby Snack" as to look at the converge_local folders for a rough idea in the forums folder.

Creating Converge applications is not for the ill at heart fainted and is something more geared towards developers only at this point (FYI a few years now). All of us were pumped up for more than a few years on how easy it would be to connect to other applications but yet the majority of us are stuck with an encoded software that we can't even connect to one application outside of Nexus & IPB without the assistance of a hired gun. So for most of us installing converge was fairly easy but the others due to the encoding may have spent days to get it running on their server(Godaddy& 1&1) to only find out that "Easily" integrate other applications was a farse sad.gif

Yes integrating IP.Board(s) works like a charm. However, if I want to connect to Joomla, Photopost, Drupal, PhPNuke, Mambo, PostNuke, Xoops, OSCommerce, X-Cart, Pearldesk, FusionBB, Moodle, E107, Hivemail, phplist, SMF, Coppermine, Gallery2, WordPress, Vbulletin, PhPfox, PHPbb3, FlashChat, AbleDating & etc. then we are SOL as (1.) the doc's don't even touch the surface on how to and (2.) I'm not a developer. Over the years we were led to believe that this would be easy as pie to accomplish but on the contrary it's painfully obvious that it's completely the opposite and not true.

My only thoughts after using it is that maybe in a future version they could incorporate something for not so advanced users to be able to bridge other databases via Q&A of the tables, fields & ID's more easily. I've seen this done in FlashChat so I know it's more than possible.

I'm not sure how the concept Converge came to light and maybe a few years ago it was because kiddies wanting to connect their boards as I'm really not sure, but here we are light years later and most of us serious clients would like to connect other software because IPB is the heart of our sites. wink.gif

So on that note, I really hope there will be more usefull information in the Converge "specific" docs than what we were directed to or led to believe was in the IP.Board docs in the past?
bfarber
Well, keep in mind though, every application is different so there's never going to be just a drop this in and it will work for every application. Each app needs it's own individual converge local folder, and in most cases other code/plugins for the application itself to actually use converge. It's an individualized process, and rightly so is going to require a developer each time.

It's really a lot more difficult than you give it credit for to make something so universal...
China J
Is it possible to get a "Converge" support area in Resources on this site like we have for the gallery and blog? I have some things to discuss and inquire about Converge that I don't believe are bugs but it's prolly by design - It pertains to importing members and admins.

Thanks
bfarber
Errr, we've had one for quite some time... unsure.gif

http://forums.invisionpower.com/index.php?showforum=409
China J
Sorry about that, I guess I was expecting to see it on the subforums on the forum index. I should have dug a little deeper before speaking. laughing.gif
RainbowViper
I just filed a Support ticket about this.

There is nothing in the Developer Docs about INSTALLING this application. Lots of info about how to make things Converge-ready.

Not one word about installation. I've tried:

Installing on a domain that I own, and on which there is no existing IP Board. Tried running one or two of the php files that looked as though they MIGHT have something to do with installation. Nope. Errors out.

Installed on domain where my test board is located. Ran a file or two in the install directory. Nope, it wants to install IP Board. Not wanting to hose my existing install, I aborted.

So WHERE is there a document telling you simply how to install this product?

For the life of me, I can't see how anyone managed to install and run this. I admit I'm a noob at IP Board. But that's not an excuse for failing to provide me with install documentation.

(And as much as I'm tempted to really blast someone for it, I'll just say that the "holder.txt" file within the Converge zip's "Documentation" folder is almost insulting.)

China J
www.mysite.com/converge/

I would advise against putting converge files in your root as they have similar file names.

so try something like this so the above url would be the install url and once install is complete it will be the same url to access converge page. to access the admin you would type this www.mysite.com/converge/admin/

bla
forums
converge
bla
bla

PS. Don't forget to create your converge database.
Keith J. Kacin
QUOTE (RainbowViper @ Apr 20 2008, 09:25 PM) *
So WHERE is there a document telling you simply how to install this product?


We have the documentation written at this point -- the things that are holding it up:
1) Final proof reading
2) Converting it to the style of the current documentation

I will follow up with this and and hopefully get some copy of it up early this week.


I know you are heavily into documentation, but understand we are working on getting all the products documented. We now have a technical writer who is devoted to upkeep of the documentation. Before this was not the case, so some products did not always have up-to-date/relevant documentation. But I assure you we are running through all the products, so we can release relevant/current docs.

On a related note, we do have knowledge base articles for some of the common actions for IP.Converge:
https://www.invisionpower.com/index.php?app...wcat&id=226
LMarkham
QUOTE (RainbowViper @ Apr 21 2008, 10:25 AM) *
I just filed a Support ticket about this.

There is nothing in the Developer Docs about INSTALLING this application. Lots of info about how to make things Converge-ready.

Not one word about installation. I've tried:

Installing on a domain that I own, and on which there is no existing IP Board. Tried running one or two of the php files that looked as though they MIGHT have something to do with installation. Nope. Errors out.

Installed on domain where my test board is located. Ran a file or two in the install directory. Nope, it wants to install IP Board. Not wanting to hose my existing install, I aborted.

So WHERE is there a document telling you simply how to install this product?

For the life of me, I can't see how anyone managed to install and run this. I admit I'm a noob at IP Board. But that's not an excuse for failing to provide me with install documentation.

(And as much as I'm tempted to really blast someone for it, I'll just say that the "holder.txt" file within the Converge zip's "Documentation" folder is almost insulting.)


RainbowViper,

I replied to your ticket. Please take a look at the response and get back with me. original.gif
RainbowViper
EDITED: I erased what I said, because I really don't want to appear to be a jerk. I'll call Support tomorrow morning.

Louis, I'll go look at your response. Thank you.

RV.
RainbowViper
OK....

To be fair to IPS, I should note that I have received more help in the last 5 minutes, from Keith and Louis, than I have in the last two weeks.

With what I now have in hand, I'm going to go try a fresh IPB install and Converge install.

RV
LMarkham
QUOTE (RainbowViper @ Apr 21 2008, 01:07 PM) *
OK....

To be fair to IPS, I should note that I have received more help in the last 5 minutes, from Keith and Louis, than I have in the last two weeks.

With what I now have in hand, I'm going to go try a fresh IPB install and Converge install.

RV


Just let us know if you need help! We are more than happy to help you out!
Keith J. Kacin
Since this has been requested by customers, I am going to post a rough draft here. Please note the final version may change slightly, but this should cover the gist of things.

Edit:

New post: http://forums.invisionpower.com/index.php?...t&p=1717982
RainbowViper
Thank you, Keith!!

Louis tried to help me further, but it seems there's some issue we haven't yet resolved. I installed it as he instructed, but then after looking at the install, even HE said it wouldn't work right, either. Glad to know I haven't completely lost my mind. I'll call Support this morning.

And that PDF looks just fine to me! I've grabbed a copy and am printing it now.

RV
Keith J. Kacin
QUOTE (RainbowViper @ Apr 21 2008, 10:34 AM) *
Thank you, Keith!!

Louis tried to help me further, but it seems there's some issue we haven't yet resolved. I installed it as he instructed, but then after looking at the install, even HE said it wouldn't work right, either. Glad to know I haven't completely lost my mind. I'll call Support this morning.

And that PDF looks just fine to me! I've grabbed a copy and am printing it now.

RV


You are welcome. original.gif

Regarding your ticket, I replied. It seems you were hitting a bug in an early release of the latest IP.Converge download.
RainbowViper
Hmm.... OK. Let me go redownload the Converge file from my Client Area. If that's all it was, I'm going to feel RATHER silly......

RV

EDIT: For anyone reading this who may benefit from the answer:

I *SHOULD* be able to just transfer the entire ZIP file to my install domain, in a subdirectory, then extract it and copy relevant files to where they should be, CHMOD as necessary, and then install......correct?
JasonIPS
The guide that Keith has posted will be in the IPS Documentation template soon.
Keith J. Kacin
QUOTE (RainbowViper @ Apr 21 2008, 11:03 AM) *
I *SHOULD* be able to just transfer the entire ZIP file to my install domain, in a subdirectory, then extract it and copy relevant files to where they should be, CHMOD as necessary, and then install......correct?


Yes, you shouldn't have issues doing it this way.

Let me know if you still have issues with the other issue. You can re-open the ticket if you need. original.gif
RainbowViper
Excellent! Thank you.
I've downloaded the latest IP Converge ZIP.
I'll go try that first. It may save a Support call (as well as much wailing, gnashing of teeth and rending of garments).

RV
RainbowViper
Hallelujah! That did it!

Converge is now installed, and I'm in the Admin controls for it.

Thanks for everyone's help.

RV
Keith J. Kacin
It has been officially released:
http://www.invisionpower.com/community/boa...umentation.html

At the bottom of this page. original.gif
Michael P
I noticed this in the draft, but didn't mention it since it was subject to change / review.

The notice on page 5
QUOTE
The only difference if IP.Converge is installed on the
same domain as the applications that will be utilizing it, IP.Converge can also set
appropriate cookies if you allow your users to directly access it.


should maybe be

QUOTE
The only difference if IP.Converge is installed on the
same domain as the applications that will be utilizing it, is that IP.Converge can also set
appropriate cookies if you allow your users to directly access it.


On re-reading it still neads cleaning up - the last bit seems also seems confusing, it took three reads to realise what it meant.
This is a "lo-fi" version of our main content. To view the full version with more information, formatting and images, please click here.
Invision Power Board © 2001-2008 Invision Power Services, Inc.