Total Commander Forum Index Total Commander
Forum - Public Discussion and Support
 
 FAQFAQ   SearchSearch   MemberlistMemberlist   UsergroupsUsergroups   RegisterRegister 
 ProfileProfile   Log in to check your private messagesLog in to check your private messages   Log inLog in 

Plugin auto-install HOWTO (TC 6.5 or newer)
Goto page 1, 2, 3  Next
 
Post new topic   Reply to topic    Total Commander Forum Index -> Plugins and addons: devel.+support (English) Printable version
View previous topic :: View next topic  
Author Message
ghisler(Author)
Site Admin
Site Admin


Joined: 04 Feb 2003
Posts: 28455
Location: Switzerland

PostPosted: Thu Nov 11, 2004 2:52 pm    Post subject: Plugin auto-install HOWTO (TC 6.5 or newer) Reply with quote

Dear plugin writers!

The next version of Total Commander, version 6.5, will make it easier for users to install plugins. When a plugin archive contains a file called pluginst.inf which describes the plugin, Total Commander will automatically offer to install the plugin (unzip to a directory, then enter it into the plugin configuration dialog). TC will offer to overwrite a plugin if it finds one with the same name already installed and configured.

Two things should be considered to handle this:
1. Some plugins come with sample INI files in the plugin directory. This is problematic because when the user installs a newer version, the user-modified INI file will be overwritten by the sample. To solve this problem, you can use a simple solution: Name the file pluginname.sample or so (just not pluginname.ini). Now when your plugin is called for the first time and reading from pluginname.ini fails, simply call CopyFile to copy pluginname.sample to pluginname.ini.

2. The pluginst.inf file. It's a simple ini file and has the following syntax:

[plugininstall]
description=Description of your plugin
descriptiondeu=German description
descriptionrus=Russian description
type=wcx
file=pluginname.wcx
defaultdir=pluginsubdir
defaultextension=ext,ext2

The description field just contains a description in English which is shown to the user when he opens the plugin archive. You can also specify descriptions in other languages - the appened string is the same as in the language file for that language, e.g. wcmd_deu.lng -> deu for German.

The type field contains the plugin type: wcx, wfx, wlx or wdx (new plugin type for file content data), lng for additional languages, or prg for the Total Commander directory.

The file field lists the actual plugin name, which will be registered in the appropriate plugin dialog.

defaultdir is the subdirectory suggested for installation. Backslashes in this will be ignored. A 2 level dir structure is proposed to the user (plugins\wcx\pluginname\).

defaultextension is only for packer plugins. The extensions must be separated by a comma. The associate dialog will be called for each extension separately.

Just ask here if you have more questions. I'm sorry but the beta test isn't public at this time, for security reasons.
_________________
Author of Total Commander
http://www.ghisler.com


Last edited by ghisler(Author) on Thu May 05, 2011 7:55 am; edited 1 time in total
Back to top
View user's profile Send private message Send e-mail Visit poster's website
ctiberg
Member
Member


Joined: 24 Oct 2003
Posts: 194
Location: Kristianstad, Sweden

PostPosted: Wed Nov 17, 2004 3:26 am    Post subject: Reply with quote

It'd be nice to have the ability to install several plugins, if they're in the same file. Our DBLister plugin for example has both a lister and a file-system plugin.. Don't know if that's unique Smile
_________________
Best regards,
Christian Tiberg
Back to top
View user's profile Send private message
Flint
Power Member
Power Member


Joined: 27 Oct 2003
Posts: 2953
Location: Moscow, Russia

PostPosted: Wed Nov 17, 2004 1:07 pm    Post subject: Reply with quote

2 ghisler(Author)
Is the WDX-plugin writer's guide available, or WDX interface is also in beta-testing? If it's in beta-testing, when (approximately, of course) it will be available?
It would be interesting to look it through, and also I have a couple of ideas for WDX-plugins to realize... Wink
_________________
Flint's Homepage: Full TC Russification Package, VirtualDisk, NTFS Links, NoClose Replacer, other stuff!
 
Using TC 8.51a / Win7 x32 & x64 SP1
Back to top
View user's profile Send private message Send e-mail Visit poster's website
ghisler(Author)
Site Admin
Site Admin


Joined: 04 Feb 2003
Posts: 28455
Location: Switzerland

PostPosted: Thu Nov 18, 2004 1:47 pm    Post subject: Reply with quote

2ctiberg
This would probably confuse too many users. The idea would be to put the plugins in separate archives inside the main archive, or in separate archives to download separately. This way a user could also install just one part of the plugin suite.

2Flint
It is in beta test, and some plugin writers are also participating in the test.
_________________
Author of Total Commander
http://www.ghisler.com
Back to top
View user's profile Send private message Send e-mail Visit poster's website
Xyzzy
Junior Member
Junior Member


Joined: 24 Nov 2004
Posts: 54
Location: Poland

PostPosted: Mon Nov 29, 2004 3:35 pm    Post subject: Reply with quote

Language plugins require putting lng and mnu in Language subdir and help file in main TCMD directory. How to specify this?

X.
Back to top
View user's profile Send private message
ghisler(Author)
Site Admin
Site Admin


Joined: 04 Feb 2003
Posts: 28455
Location: Switzerland

PostPosted: Mon Nov 29, 2004 3:46 pm    Post subject: Reply with quote

Language files will be put in the language subdir automatically, not need to handle this. Help file installation isn't automated at this time, sorry.
_________________
Author of Total Commander
http://www.ghisler.com
Back to top
View user's profile Send private message Send e-mail Visit poster's website
Dark One
Junior Member
Junior Member


Joined: 19 May 2003
Posts: 40
Location: Serbia

PostPosted: Tue Dec 07, 2004 9:26 pm    Post subject: Reply with quote

please be more precise on the following:
1) description - how long should it be? i.e. what is it supposed to fit into - a short label (meaning just the name and version) or a long multiline label (allowing for some functionality intro)?
2) defaultdir - what directory is it relative to? does the directory structure for plugins remain arbitrary? if not, allow defaultdir=. to mean "do not create a separate directory, just place a plugin along with others of the same type"
3) version - how do you make out which one is newer? do we have to include version in the description in order for it to be displayed to plugin user?

recomendation: add a new field: readme=myreadme.txt and a button on your new dialog which will allow users to see plugin's readme file. perhaps also readmedeu=myreadme.de readmerus=myreadme.ru or a combo box like in Kconfigure. allow html files along with txt...
Back to top
View user's profile Send private message
ghisler(Author)
Site Admin
Site Admin


Joined: 04 Feb 2003
Posts: 28455
Location: Switzerland

PostPosted: Fri Dec 10, 2004 11:38 am    Post subject: Reply with quote

1) 255 characters max. (short description shown in message box).
2) It's relative to the last used base directory chosen by the user, plus a plugin-type specific dir, e.g. basedir\wfx\<pluginname>
3) You can't - this should be checked by the user before downloading, it's too late when he has already downloaded it (you shouldn't download dozens of plugins again and again for no reason).
_________________
Author of Total Commander
http://www.ghisler.com
Back to top
View user's profile Send private message Send e-mail Visit poster's website
Dark One
Junior Member
Junior Member


Joined: 19 May 2003
Posts: 40
Location: Serbia

PostPosted: Sat Dec 25, 2004 12:12 am    Post subject: Reply with quote

But one may wan't to enter the archive multiple times without worrying about downgrading the plugin. Why don't you add a version=x.x[.x.x] field that you will use to check and compare versions?
Back to top
View user's profile Send private message
XPKiller
Junior Member
Junior Member


Joined: 03 Jan 2005
Posts: 2

PostPosted: Mon Jan 03, 2005 5:15 am    Post subject: Reply with quote

When is the new version going to be available?
Back to top
View user's profile Send private message
Hacker
Moderator
Moderator


Joined: 06 Feb 2003
Posts: 9498
Location: Bratislava, Slovakia

PostPosted: Mon Jan 03, 2005 7:25 am    Post subject: Reply with quote

This month, presumably.

Roman
_________________
Mal angenommen, du drückst Strg+F, wählst die FTP-Verbindung (mit gespeichertem Passwort), klickst aber nicht auf Verbinden, sondern fällst tot um.

Donations
BTC: 16KGZbrQZqATnY1Yfhb8RcWkfyybv2UHb8
LTC: LgwzV7fxgWGkBBhQ5k6uFiB69hN6bG6n78
Back to top
View user's profile Send private message Send e-mail Visit poster's website
ctiberg
Member
Member


Joined: 24 Oct 2003
Posts: 194
Location: Kristianstad, Sweden

PostPosted: Fri Jan 28, 2005 9:22 am    Post subject: Reply with quote

ghisler(Author) wrote:
2ctiberg
This would probably confuse too many users. The idea would be to put the plugins in separate archives inside the main archive, or in separate archives to download separately. This way a user could also install just one part of the plugin suite.


The problem with this is when you've got one main plugin DLL, with all the features, and small "stubs" that are installed in TC. This isn't possible to do with your current way of installing plugins Sad
_________________
Best regards,
Christian Tiberg
Back to top
View user's profile Send private message
Evgeny
Junior Member
Junior Member


Joined: 31 Jan 2005
Posts: 6

PostPosted: Mon Jan 31, 2005 4:59 am    Post subject: Re: Making your plugin ready for Total Commander 6.5 Reply with quote

Dear Mr. Ghisler,
Please what we need to change in Lister plugin to make it work with thumbnails?
Also we suggest to make easy deleting the plugin in similar way as creating. So the program can ask not 'Do you want to install it' but 'Do you want to install or uninstall it?'.
Thank you!
Back to top
View user's profile Send private message
franck8244
Power Member
Power Member


Joined: 06 Mar 2003
Posts: 700
Location: Geneva...

PostPosted: Mon Jan 31, 2005 6:59 am    Post subject: Re: Making your plugin ready for Total Commander 6.5 Reply with quote

Evgeny wrote:
Please what we need to change in Lister plugin to make it work with thumbnails?


Simply download the new version of the help file for lister plugin writer, Here is a link ...

There is a new function to add in your plugin...
_________________
TC#88260 -
Back to top
View user's profile Send private message Send e-mail AIM Address Yahoo Messenger MSN Messenger
Evgeny
Junior Member
Junior Member


Joined: 31 Jan 2005
Posts: 6

PostPosted: Mon Jan 31, 2005 8:53 am    Post subject: Re: Making your plugin ready for Total Commander 6.5 Reply with quote

franck8244 wrote:
Evgeny wrote:
Please what we need to change in Lister plugin to make it work with thumbnails?


Simply download the new version of the help file for lister plugin writer, Here is a link ...

There is a new function to add in your plugin...


Thank you!!!
We will deal with this right now:)
Back to top
View user's profile Send private message
Display posts from previous:   
Post new topic   Reply to topic    Total Commander Forum Index -> Plugins and addons: devel.+support (English) All times are GMT - 6 Hours
Goto page 1, 2, 3  Next
Page 1 of 3

 
Jump to:  
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum


Impressum: This site is maintained by Ghisler Software GmbH

Using phpBB © 2001-2005 phpBB Group