Wiki Francophone de Maxthon - Contributions [fr]

L'isolateur de Maxthon v2.5

2009-01-30T07:08:39Z

Ray1 :

''Voici une copie d'un important communiqué de presse qui a été envoyé aux éditeurs, aux rédacteurs, et aux blogueurs du monde entier. Vous serez peut-être intéressé également.''

'''La dernière fonctionnalité de Maxthon, l'isolateur, protège les autres onglets du 'gel' lorsque l'un d'eux ne fonctionne plus.'''

'''Beijing – Maxthon International''' a publié cette semaine, une nouvelle version bêta de son navigateur Internet, Maxthon 2.5.1, qui inclut une fonctionnalité appelée l'isolateur qui sépare les fonctions de chaque onglet par rapport aux autres onglets et aux autres parties du navigateur. L'isolateur protège les autres onglets afin d'éviter qu'ils se figent à cause d'un seul onglet qui ne répond plus aux systèmes et qui monopolise toutes les ressources de l'ordinateur.

Les ingénieurs de Maxthon ont redéfini le Framework du navigateur, afin que chaque onglet associé à un site Web fonctionne indépendamment les uns des autres. Avec cette nouvelle architecture, si un onglet ne répond plus, pour une raison quelconque, les autres onglets et le navigateur ne sont pas affectés. L'utilisateur peut continuer à naviguer normalement et peut actualiser, rouvrir, ou fermer l'onglet qui est à l'origine du problème.

«Fondamentalement, notre technologie sépare l'onglet et le navigateur», a déclaré Jeff Chen, chef de la direction de Maxthon. "C'est pourquoi l'onglet en cause n'affectera pas les performances du navigateur, et ainsi le navigateur offrira un meilleur environnement pour exécuter des applications Web dans des onglets.

"Pour autant que je sache, aucun autre navigateur ne dispose d'une telle fonction», dit Chen.

Les pages de tests présents à l'adresse http://maxthon.com/test/ http://maxthon.com/test/ fournissent différents exemples de blocages qui peuvent arrêter l'activité de tous les onglets du navigateur. L'une affiche une page où un script ne peut pas charger une animation Flash. Une autre émule l'effet d'un onglet bloqué par un script qui est entré dans une boucle infinie. Voir le blog, http://blog.maxthon.com/?p=178" Lignes directrices pour tester la technologie d'isolation de Maxthon[/url]" pour une description complète de tous les tests.
Les effets des pages de test s'arrêtent automatiquement après quelques secondes de sorte qu'ils peuvent être contrôlés par les navigateurs qui n'ont pas la technologie d'isolation.

Chen a expliqué que le blocage de l'onglet se produit le plus souvent dans des situations spécifiques :

- Lorsque l'onglet est occupé au chargement d'une grande quantité de données, il est parfois gelé. Chen a dit que Microsoft Internet Explorer souffre souvent de cette situation.

- Lorsqu'une boîte de dialogue, comme une alerte ou un avertissement, apparaît sur la page et que l'utilisateur ne peut pas passer à autre onglet sans fermer la boîte de dialogue. Tous les navigateurs ont ce problème, d'après Chen.

- Lorsque l'onglet a un autre contrôle, comme un jeu en Flash, qui utilise un délai de traitement important, l'onglet peut geler, en entraînant les autres onglets du navigateur, un phénomène fréquent avec les autres navigateurs, d'après Chen.

Traduction d'un [http://blog.maxthon.com/?p=176 article de presse] qui est paru sur le [http://blog.maxthon.com/ Blog anglais de Maxthon].

L'isolateur de Maxthon v2.5

2009-01-30T07:07:19Z

Ray1 :

'''La dernière fonctionnalité de Maxthon, l'isolateur, protège les autres onglets du 'gel' lorsque l'un d'eux ne fonctionne plus.'''

''Voici une copie d'un important communiqué de presse qui a été envoyé aux éditeurs, aux rédacteurs, et aux blogueurs du monde entier. Vous serez peut-être intéressé également.''

'''Beijing – Maxthon International''' a publié cette semaine, une nouvelle version bêta de son navigateur Internet, Maxthon 2.5.1, qui inclut une fonctionnalité appelée l'isolateur qui sépare les fonctions de chaque onglet par rapport aux autres onglets et aux autres parties du navigateur. L'isolateur protège les autres onglets afin d'éviter qu'ils se figent à cause d'un seul onglet qui ne répond plus aux systèmes et qui monopolise toutes les ressources de l'ordinateur.

Les ingénieurs de Maxthon ont redéfini le Framework du navigateur, afin que chaque onglet associé à un site Web fonctionne indépendamment les uns des autres. Avec cette nouvelle architecture, si un onglet ne répond plus, pour une raison quelconque, les autres onglets et le navigateur ne sont pas affectés. L'utilisateur peut continuer à naviguer normalement et peut actualiser, rouvrir, ou fermer l'onglet qui est à l'origine du problème.

«Fondamentalement, notre technologie sépare l'onglet et le navigateur», a déclaré Jeff Chen, chef de la direction de Maxthon. "C'est pourquoi l'onglet en cause n'affectera pas les performances du navigateur, et ainsi le navigateur offrira un meilleur environnement pour exécuter des applications Web dans des onglets.

"Pour autant que je sache, aucun autre navigateur ne dispose d'une telle fonction», dit Chen.

Les pages de tests présents à l'adresse http://maxthon.com/test/ http://maxthon.com/test/ fournissent différents exemples de blocages qui peuvent arrêter l'activité de tous les onglets du navigateur. L'une affiche une page où un script ne peut pas charger une animation Flash. Une autre émule l'effet d'un onglet bloqué par un script qui est entré dans une boucle infinie. Voir le blog, http://blog.maxthon.com/?p=178" Lignes directrices pour tester la technologie d'isolation de Maxthon[/url]" pour une description complète de tous les tests.
Les effets des pages de test s'arrêtent automatiquement après quelques secondes de sorte qu'ils peuvent être contrôlés par les navigateurs qui n'ont pas la technologie d'isolation.

Chen a expliqué que le blocage de l'onglet se produit le plus souvent dans des situations spécifiques :

- Lorsque l'onglet est occupé au chargement d'une grande quantité de données, il est parfois gelé. Chen a dit que Microsoft Internet Explorer souffre souvent de cette situation.

- Lorsqu'une boîte de dialogue, comme une alerte ou un avertissement, apparaît sur la page et que l'utilisateur ne peut pas passer à autre onglet sans fermer la boîte de dialogue. Tous les navigateurs ont ce problème, d'après Chen.

- Lorsque l'onglet a un autre contrôle, comme un jeu en Flash, qui utilise un délai de traitement important, l'onglet peut geler, en entraînant les autres onglets du navigateur, un phénomène fréquent avec les autres navigateurs, d'après Chen.

Traduction d'un [http://blog.maxthon.com/?p=176 article de presse] qui est paru sur le [http://blog.maxthon.com/ Blog anglais de Maxthon].

L'isolateur de Maxthon v2.5

2009-01-30T06:40:33Z

Ray1 :

== La dernière fonctionnalité de Maxthon, l'isolateur, protège les autres onglets du 'gel' lorsque l'un d'eux ne fonctionne plus. ==

Voici une copie d'un important communiqué de presse qui a été envoyé aux éditeurs, aux rédacteurs, et aux blogueurs du monde entier. Vous serez peut-être intéressé également.[/i]

'''Beijing – Maxthon International''' a publié cette semaine, une nouvelle version bêta de son navigateur Internet, Maxthon 2.5.1, qui inclut une fonctionnalité appelée l'isolateur qui sépare les fonctions de chaque onglet par rapport aux autres onglets et aux autres parties du navigateur. L'isolateur protège les autres onglets afin d'éviter qu'ils se figent à cause d'un seul onglet qui ne répond plus aux systèmes et qui monopolise toutes les ressources de l'ordinateur.

Les ingénieurs de Maxthon ont redéfini le Framework du navigateur, afin que chaque onglet associé à un site Web fonctionne indépendamment les uns des autres. Avec cette nouvelle architecture, si un onglet ne répond plus, pour une raison quelconque, les autres onglets et le navigateur ne sont pas affectés. L'utilisateur peut continuer à naviguer normalement et peut actualiser, rouvrir, ou fermer l'onglet qui est à l'origine du problème.

«Fondamentalement, notre technologie sépare l'onglet et le navigateur», a déclaré Jeff Chen, chef de la direction de Maxthon. "C'est pourquoi l'onglet en cause n'affectera pas les performances du navigateur, et ainsi le navigateur offrira un meilleur environnement pour exécuter des applications Web dans des onglets.

"Pour autant que je sache, aucun autre navigateur ne dispose d'une telle fonction», dit Chen.

Les pages de tests présents à l'adresse http://maxthon.com/test/ http://maxthon.com/test/ fournissent différents exemples de blocages qui peuvent arrêter l'activité de tous les onglets du navigateur. L'une affiche une page où un script ne peut pas charger une animation Flash. Une autre émule l'effet d'un onglet bloqué par un script qui est entré dans une boucle infinie. Voir le blog, http://blog.maxthon.com/?p=178" Lignes directrices pour tester la technologie d'isolation de Maxthon[/url]" pour une description complète de tous les tests.
Les effets des pages de test s'arrêtent automatiquement après quelques secondes de sorte qu'ils peuvent être contrôlés par les navigateurs qui n'ont pas la technologie d'isolation.

Chen a expliqué que le blocage de l'onglet se produit le plus souvent dans des situations spécifiques :

- Lorsque l'onglet est occupé au chargement d'une grande quantité de données, il est parfois gelé. Chen a dit que Microsoft Internet Explorer souffre souvent de cette situation.

- Lorsqu'une boîte de dialogue, comme une alerte ou un avertissement, apparaît sur la page et que l'utilisateur ne peut pas passer à autre onglet sans fermer la boîte de dialogue. Tous les navigateurs ont ce problème, d'après Chen.

- Lorsque l'onglet a un autre contrôle, comme un jeu en Flash, qui utilise un délai de traitement important, l'onglet peut geler, en entraînant les autres onglets du navigateur, un phénomène fréquent avec les autres navigateurs, d'après Chen.

L'isolateur de Maxthon v2.5

2009-01-30T05:44:29Z

Ray1 :

== La dernière fonctionnalité de Maxthon, l'isolateur, protège les autres onglets du 'gel' lorsque l'un d'eux ne fonctionne plus. ==

Voici une copie d'un important communiqué de presse qui a été envoyé aux éditeurs, aux rédacteurs, et aux blogueurs du monde entier. Vous serez peut-être intéressé également.[/i]

Beijing – Maxthon International a publié cette semaine, une nouvelle version bêta de son navigateur Internet, Maxthon 2.5.1, qui inclut une fonctionnalité appelée l'isolateur qui sépare les fonctions de chaque onglet par rapport aux autres onglets et aux autres parties du navigateur. L'isolateur protège les autres onglets afin d'éviter qu'ils se figent à cause d'un seul onglet qui ne répond plus aux systèmes et qui monopolise toutes les ressources de l'ordinateur.

Les ingénieurs de Maxthon ont redéfini le Framework du navigateur, afin que chaque onglet associé à un site Web fonctionne indépendamment les uns des autres. Avec cette nouvelle architecture, si un onglet ne répond plus, pour une raison quelconque, les autres onglets et le navigateur ne sont pas affectés. L'utilisateur peut continuer à naviguer normalement et peut actualiser, rouvrir, ou fermer l'onglet qui est à l'origine du problème.

«Fondamentalement, notre technologie sépare l'onglet et le navigateur», a déclaré Jeff Chen, chef de la direction de Maxthon. "C'est pourquoi l'onglet en cause n'affectera pas les performances du navigateur, et ainsi le navigateur offrira un meilleur environnement pour exécuter des applications Web dans des onglets.

"Pour autant que je sache, aucun autre navigateur ne dispose d'une telle fonction», dit Chen.

Les pages de tests présents à l'adresse [url="http://maxthon.com/test/"]http://maxthon.com/test/[/url] fournissent différents exemples de blocages qui peuvent arrêter l'activité de tous les onglets du navigateur. L'une affiche une page où un script ne peut pas charger une animation Flash. Une autre émule l'effet d'un onglet bloqué par un script qui est entré dans une boucle infinie. Voir le blog, «[url="http://blog.maxthon.com/?p=178"]Lignes directrices pour tester la technologie d'isolation de Maxthon[/url]" pour une description complète de tous les tests.
Les effets des pages de test s'arrêtent automatiquement après quelques secondes de sorte qu'ils peuvent être contrôlés par les navigateurs qui n'ont pas la technologie d'isolation.

Chen a expliqué que le blocage de l'onglet se produit le plus souvent dans des situations spécifiques :

- Lorsque l'onglet est occupé au chargement d'une grande quantité de données, il est parfois gelé. Chen a dit que Microsoft Internet Explorer souffre souvent de cette situation.

- Lorsqu'une boîte de dialogue, comme une alerte ou un avertissement, apparaît sur la page et que l'utilisateur ne peut pas passer à autre onglet sans fermer la boîte de dialogue. Tous les navigateurs ont ce problème, d'après Chen.

- Lorsque l'onglet a un autre contrôle, comme un jeu en Flash, qui utilise un délai de traitement important, l'onglet peut geler, en entraînant les autres onglets du navigateur, un phénomène fréquent avec les autres navigateurs, d'après Chen.

Base de connaissances de Maxthon 2.0

2009-01-30T05:41:03Z

Ray1 :

==Vue d'ensemble==
Bienvenue sur la base de connaissances de Maxthon v2.0.
Vous pourrez trouver ici des manuels et des documentations pour Maxthon v2.0.

Si vous n'avez pas encore essayé Maxthon, vous pouvez vous procurer une version de démonstration de Maxthon v2.0 dans la section Beta Test de [http://forum.maxthon.com/index.php?showtopic=46355 notre Forum].

==Pour les utilisateurs==
* [[Les caractéristiques de Maxthon v2.0]]. Nouveau
* [[L’accélérateur de site de Maxthon v2.0]]. Nouveau
* [[L'isolateur de Maxthon v2.5]]. Nouveau

==Pour les développeurs==
* [[Les Skins de Maxthon v2.0]]. Nouveau
* [[Les scripts de Maxthon v2.0]]. Nouveau
* [[Les filtres personnalisés de Maxthon v2.0]].
* [[Les listes de Proxy de Maxthon v2.0]]. Nouveau
* [[Les fichiers de configuration de Maxthon v2.0]]. Nouveau

<center>[[Accueil]]</center>

L’accélérateur de site de Maxthon v2.0

2008-10-25T15:03:27Z

Ray1 : /* '''Introduction à l’accélérateur de site de Maxthon''' */

== '''Introduction à l’accélérateur de site de Maxthon''' ==

Il y a longtemps que les utilisateurs attendaient la vitesse d'Opera couplée aux fonctionnalités riches de Maxthon. Nous avons activement recherché une solution d'amélioration de la vitesse et le dernier AIM(1) ou MSA(2) en est le résultat, et se compose de plusieurs optimisations basées sur les habitudes générales des utilisateurs, l'efficacité des transmissions réseau, le mécanisme de cache de navigation et l'intelligence d'interprétation du contenu.

* (1) AIM : (en français) Accélération Intelligente de Maxthon
* (2) MSA : (en anglais) Maxthon Smart Acceleration

'''Actuellement, AIM a deux modes d'accélération :'''

*Mode d'accélération par défaut (activé par défaut) lecture rapide sans panne et emploie une approche relativement conservatrice pour une bonne vitesse de navigation sans poser de problème.
*Mode super accélération (activé sur chaque site à partir du bouton en forme d'éclair de la barre d'état) vise une vitesse maximale de navigation et améliorera la vitesse de navigation très sensiblement, particulièrement sur les sites fréquemment visités et avec une faible connectivité.

'''Quand AIM doit être employé et dans quel mode ?'''

Normalement, la majorité des utilisateurs peuvent activer le mode d'accélération par défaut pour une meilleure vitesse de navigation. Pour les utilisateurs qui visitent fréquemment les mêmes sites avec une faible connectivité, ils peuvent utiliser le super mode d'accélération pour ces sites.

'''Quels sont les inconvénients, s'il y en a ?'''

Avec le mode super accélération actif, certaines pages Web peuvent ne pas être toujours mises à jour. Ceci se produit habituellement sur certains sites. Les utilisateurs peuvent sélectivement activer le super mode d'accélération seulement pour les sites qui ne posent pas ce problème.

'''Dans quelles circonstances l'amélioration de la vitesse n'est pas notable ?'''

L'AIM est conçu pour fonctionner le plus efficacement sur des sites Web avec une faible connectivité et fréquemment visités. L'amélioration de la vitesse. Elle peut ne pas être apparente pour des utilisateurs ayant une large bande passante ou visitant la plupart du temps des sites avec une large bande passante. En outre, l'amélioration de vitesse peut ne pas être apparente pour des sites visités peu souvent.

'''Quels sont les avantages de l'AIM pour les administrateurs Web ?'''

Puisque l'AIM assure une utilisation plus efficace de la connexion Internet et du cache du navigateur, il contribue à diminuer la charge des serveurs. Les serveurs peuvent ainsi accueillir plus de visiteurs et dans de meilleures conditions. En outre, les administrateurs Web peuvent diminuer les coûts d'exploitation avec une utilisation plus efficace de la bande passante des serveurs.

* Traduction par '''Ldfa''' et '''Ricouz''' de l'article de [http://forum.maxthon.com/viewthread.php?tid=56889&extra=page%3D1 abc@home] sur le Forum Officiel.

L’accélérateur de site de Maxthon v2.0

2008-10-25T15:02:09Z

Ray1 : /* '''Introduction à l’accélérateur de site de Maxthon''' */

== '''Introduction à l’accélérateur de site de Maxthon''' ==

Il y a longtemps que les utilisateurs attendaient la vitesse d'Opera couplée aux fonctionnalités riches de Maxthon. Nous avons activement recherché une solution d'amélioration de la vitesse et le dernier AIM(1) ou MSA(2) en est le résultat, et se compose de plusieurs optimisations basées sur les habitudes générales des utilisateurs, l'efficacité des transmissions réseau, le mécanisme de cache de navigation et l'intelligence d'interprétation du contenu.

(1) AIM : (en français) Accélération Intelligente de Maxthon
(2) MSA : (en anglais) Maxthon Smart Acceleration

'''Actuellement, AIM a deux modes d'accélération :'''

*Mode d'accélération par défaut (activé par défaut) lecture rapide sans panne et emploie une approche relativement conservatrice pour une bonne vitesse de navigation sans poser de problème.
*Mode super accélération (activé sur chaque site à partir du bouton en forme d'éclair de la barre d'état) vise une vitesse maximale de navigation et améliorera la vitesse de navigation très sensiblement, particulièrement sur les sites fréquemment visités et avec une faible connectivité.

'''Quand AIM doit être employé et dans quel mode ?'''

Normalement, la majorité des utilisateurs peuvent activer le mode d'accélération par défaut pour une meilleure vitesse de navigation. Pour les utilisateurs qui visitent fréquemment les mêmes sites avec une faible connectivité, ils peuvent utiliser le super mode d'accélération pour ces sites.

'''Quels sont les inconvénients, s'il y en a ?'''

Avec le mode super accélération actif, certaines pages Web peuvent ne pas être toujours mises à jour. Ceci se produit habituellement sur certains sites. Les utilisateurs peuvent sélectivement activer le super mode d'accélération seulement pour les sites qui ne posent pas ce problème.

'''Dans quelles circonstances l'amélioration de la vitesse n'est pas notable ?'''

L'AIM est conçu pour fonctionner le plus efficacement sur des sites Web avec une faible connectivité et fréquemment visités. L'amélioration de la vitesse. Elle peut ne pas être apparente pour des utilisateurs ayant une large bande passante ou visitant la plupart du temps des sites avec une large bande passante. En outre, l'amélioration de vitesse peut ne pas être apparente pour des sites visités peu souvent.

'''Quels sont les avantages de l'AIM pour les administrateurs Web ?'''

Puisque l'AIM assure une utilisation plus efficace de la connexion Internet et du cache du navigateur, il contribue à diminuer la charge des serveurs. Les serveurs peuvent ainsi accueillir plus de visiteurs et dans de meilleures conditions. En outre, les administrateurs Web peuvent diminuer les coûts d'exploitation avec une utilisation plus efficace de la bande passante des serveurs.

* Traduction par '''Ldfa''' et '''Ricouz''' de l'article de [http://forum.maxthon.com/viewthread.php?tid=56889&extra=page%3D1 abc@home] sur le Forum Officiel.

L’accélérateur de site de Maxthon v2.0

2008-10-25T14:46:07Z

Ray1 : /* '''Introduction à l’accélérateur de site de Maxthon''' */

== '''Introduction à l’accélérateur de site de Maxthon''' ==

Il y a longtemps que les utilisateurs attendaient la vitesse d'Opera couplée aux fonctionnalités riches de Maxthon. Nous avons activement recherché une solution d'amélioration de la vitesse et le dernier AIM(1) ou MSA(2) en est le résultat, et se compose de plusieurs optimisations basées sur les habitudes générales des utilisateurs, l'efficacité des transmissions réseau, le mécanisme de cache de navigation et l'intelligence d'interprétation du contenu.

(1) AIM : (en français) Accélération Intelligente de Maxthon
(2) MSA : (en anglais) Maxthon Smart Acceleration

'''Actuellement AIM a deux modes d'accélération :'''

*Mode d'accélération par défaut (activé par défaut) lecture rapide sans panne et emploie une approche relativement conservatrice pour une bonne vitesse de navigation sans poser de problème.
*Mode super accélération (activé sur chaque site à partir du bouton en forme d'éclair de la barre d'état) vise une vitesse maximale de navigation et améliorera la vitesse de navigation très sensiblement, particulièrement sur les sites fréquemment visités et avec une faible connectivité.

'''Quand AIM doit être employé et dans quel mode ?'''

Normalement, la majorité des utilisateurs peuvent activer le mode d'accélération par défaut pour une meilleure vitesse de navigation. Pour les utilisateurs qui visitent fréquemment les mêmes sites avec une faible connectivité, ils peuvent utiliser le super mode d'accélération pour ces sites.

'''Quels sont les inconvénients, s'il y en a ?'''

Avec le mode super accélération actif, certaines pages Web peuvent ne pas être toujours mises à jour. Ceci se produit habituellement sur certains sites. Les utilisateurs peuvent sélectivement activer le super mode d'accélération seulement pour les sites qui ne posent pas ce problème.

'''Dans quelles circonstances l'amélioration de la vitesse n'est pas notable ?'''

L'AIM est conçu pour fonctionner le plus efficacement sur des sites Web avec une faible connectivité et fréquemment visités. L'amélioration de la vitesse. Elle peut ne pas être apparente pour des utilisateurs ayant une large bande passante ou visitant la plupart du temps des sites avec une large bande passante. En outre, l'amélioration de vitesse peut ne pas être apparente pour des sites visités peu souvent.

'''Quels sont les avantages de l'AIM pour les administrateurs Web ?'''

Puisque l'AIM assure une utilisation plus efficace de la connexion Internet et du cache du navigateur, il contribue à diminuer la charge des serveurs. Les serveurs peuvent ainsi accueillir plus de visiteurs et dans de meilleures conditions. En outre, les administrateurs Web peuvent diminuer les coûts d'exploitation avec une utilisation plus efficace de la bande passante des serveurs.

* Traduction par '''Ldfa''' et '''Ricouz''' de l'article de [http://forum.maxthon.com/viewthread.php?tid=56889&extra=page%3D1 abc@home] sur le Forum Officiel.

L’accélérateur de site de Maxthon v2.0

2008-10-25T14:45:40Z

Ray1 : /* '''Introduction à l’accélérateur de site de Maxthon''' */

== '''Introduction à l’accélérateur de site de Maxthon''' ==

Il y a longtemps que les utilisateurs attendaient la vitesse d'Opera couplée aux fonctionnalités riches de Maxthon. Nous avons activement recherché une solution d'amélioration de la vitesse et le dernier AIM(1) ou MSA(2) en est le résultat, et se compose de plusieurs optimisations basées sur les habitudes générales des utilisateurs, l'efficacité des transmissions réseau, le mécanisme de cache de navigation et l'intelligence d'interprétation du contenu.

(1) AIM : (en français) Accélération Intelligente de Maxthon
(2) MSA : (en anglais) Maxthon Smart Acceleration

'''Actuellement AIM a deux modes d'accélération :'''

*Mode d'accélération par défaut (activé par défaut) lecture rapide sans panne et emploie une approche relativement conservatrice pour une bonne vitesse de navigation sans poser de problème.
*Mode super accélération (activé sur chaque site à partir du bouton en forme d'éclair de la barre d'état) vise une vitesse maximale de navigation et améliorera la vitesse de navigation très sensiblement, particulièrement sur les sites fréquemment visités et avec une faible connectivité.

'''Quand AIM doit être employé et dans quel mode ?'''

Normalement, la majorité des utilisateurs peuvent activer le mode d'accélération par défaut pour une meilleure vitesse de navigation. Pour les utilisateurs qui visitent fréquemment les mêmes sites avec une faible connectivité, ils peuvent utiliser le super mode d'accélération pour ces sites.

'''Quels sont les inconvénients, s'il y en a ?'''

Avec le mode super accélération actif, certaines pages Web peuvent ne pas être toujours mises à jour. Ceci se produit habituellement sur certains sites. Les utilisateurs peuvent sélectivement activer le super mode d'accélération seulement pour les sites qui ne posent pas ce problème.

'''Dans quelles circonstances l'amélioration de la vitesse n'est pas notable ?'''

L'AIM est conçu pour fonctionner le plus efficacement sur des sites Web avec une faible connectivité et fréquemment visités. L'amélioration de la vitesse. Elle peut ne pas être apparente pour des utilisateurs ayant une large bande passante ou visitant la plupart du temps des sites avec une large bande passante. En outre, l'amélioration de vitesse peut ne pas être apparente pour des sites visités peu souvent.

'''Quels sont les avantages de l'AIM pour les administrateurs Web ?'''

Puisque l'AIM assure une utilisation plus efficace de la connexion Internet et du cache du navigateur, il contribue à diminuer la charge des serveurs. Les serveurs peuvent ainsi accueillir plus de visiteurs et dans de meilleures conditions. En outre, les administrateurs Web peuvent diminuer les coûts d'exploitation avec une utilisation plus efficace de la bande passante des serveurs.

Traduction par '''Ldfa''' et '''Ricouz''' de l'article de [http://forum.maxthon.com/viewthread.php?tid=56889&extra=page%3D1 abc@home] sur le Forum Officiel.

L’accélérateur de site de Maxthon v2.0

2008-10-25T14:43:25Z

Ray1 : /* '''Introduction à l’accélérateur de site de Maxthon''' */

== '''Introduction à l’accélérateur de site de Maxthon''' ==

Il y a longtemps que les utilisateurs attendaient la vitesse d'Opera couplée aux fonctionnalités riches de Maxthon. Nous avons activement recherché une solution d'amélioration de la vitesse et le dernier AIM(1) ou MSA(2) en est le résultat, et se compose de plusieurs optimisations basées sur les habitudes générales des utilisateurs, l'efficacité des transmissions réseau, le mécanisme de cache de navigation et l'intelligence d'interprétation du contenu.

(1) AIM : (en français) Accélération Intelligente de Maxthon
(2) MSA : (en anglais) Maxthon Smart Acceleration

'''Actuellement AIM a deux modes d'accélération :'''

*Mode d'accélération par défaut (activé par défaut) lecture rapide sans panne et emploie une approche relativement conservatrice pour une bonne vitesse de navigation sans poser de problème.
*Mode super accélération (activé sur chaque site à partir du bouton en forme d'éclair de la barre d'état) vise une vitesse maximale de navigation et améliorera la vitesse de navigation très sensiblement, particulièrement sur les sites fréquemment visités et avec une faible connectivité.

'''Quand AIM doit être employé et dans quel mode ?'''

Normalement, la majorité des utilisateurs peuvent activer le mode d'accélération par défaut pour une meilleure vitesse de navigation. Pour les utilisateurs qui visitent fréquemment les mêmes sites avec une faible connectivité, ils peuvent utiliser le super mode d'accélération pour ces sites.

'''Quels sont les inconvénients, s'il y en a ?'''

Avec le mode super accélération actif, certaines pages Web peuvent ne pas être toujours mises à jour. Ceci se produit habituellement sur certains sites. Les utilisateurs peuvent sélectivement activer le super mode d'accélération seulement pour les sites qui ne posent pas ce problème.

'''Dans quelles circonstances l'amélioration de la vitesse n'est pas notable ?'''

L'AIM est conçu pour fonctionner le plus efficacement sur des sites Web avec une faible connectivité et fréquemment visités. L'amélioration de la vitesse. Elle peut ne pas être apparente pour des utilisateurs ayant une large bande passante ou visitant la plupart du temps des sites avec une large bande passante. En outre, l'amélioration de vitesse peut ne pas être apparente pour des sites visités peu souvent.

'''Quels sont les avantages de l'AIM pour les administrateurs Web ?'''

Puisque l'AIM assure une utilisation plus efficace de la connexion Internet et du cache du navigateur, il contribue à diminuer la charge des serveurs. Les serveurs peuvent ainsi accueillir plus de visiteurs et dans de meilleures conditions. En outre, les administrateurs Web peuvent diminuer les coûts d'exploitation avec une utilisation plus efficace de la bande passante des serveurs.

Traduction par '''Ldfa''' et '''ricouz''' de l'article de [abc@home http://forum.maxthon.com/viewthread.php?tid=56889&extra=page%3D1] sur le Forum Officiel.

L’accélérateur de site de Maxthon v2.0

2008-10-25T14:39:32Z

Ray1 :

== '''Introduction à l’accélérateur de site de Maxthon''' ==

Il y a longtemps que les utilisateurs attendaient la vitesse d'Opera couplée aux fonctionnalités riches de Maxthon. Nous avons activement recherché une solution d'amélioration de la vitesse et le dernier AIM(1) ou MSA(2) en est le résultat, et se compose de plusieurs optimisations basées sur les habitudes générales des utilisateurs, l'efficacité des transmissions réseau, le mécanisme de cache de navigation et l'intelligence d'interprétation du contenu.

(1) AIM : (en français) Accélération Intelligente de Maxthon
(2) MSA : (en anglais) Maxthon Smart Acceleration

'''Actuellement AIM a deux modes d'accélération :'''

*Mode d'accélération par défaut (activé par défaut) lecture rapide sans panne et emploie une approche relativement conservatrice pour une bonne vitesse de navigation sans poser de problème.
*Mode super accélération (activé sur chaque site à partir du bouton en forme d'éclair de la barre d'état) vise une vitesse maximale de navigation et améliorera la vitesse de navigation très sensiblement, particulièrement sur les sites fréquemment visités et avec une faible connectivité.

'''Quand AIM doit être employé et dans quel mode ?'''

Normalement, la majorité des utilisateurs peuvent activer le mode d'accélération par défaut pour une meilleure vitesse de navigation. Pour les utilisateurs qui visitent fréquemment les mêmes sites avec une faible connectivité, ils peuvent utiliser le super mode d'accélération pour ces sites.

'''Quels sont les inconvénients, s'il y en a ?'''

Avec le mode super accélération actif, certaines pages Web peuvent ne pas être toujours mises à jour. Ceci se produit habituellement sur certains sites. Les utilisateurs peuvent sélectivement activer le super mode d'accélération seulement pour les sites qui ne posent pas ce problème.

'''Dans quelles circonstances l'amélioration de la vitesse n'est pas notable ?'''

L'AIM est conçu pour fonctionner le plus efficacement sur des sites Web avec une faible connectivité et fréquemment visités. L'amélioration de la vitesse. Elle peut ne pas être apparente pour des utilisateurs ayant une large bande passante ou visitant la plupart du temps des sites avec une large bande passante. En outre, l'amélioration de vitesse peut ne pas être apparente pour des sites visités peu souvent.

'''Quels sont les avantages de l'AIM pour les administrateurs Web ?'''

Puisque l'AIM assure une utilisation plus efficace de la connexion Internet et du cache du navigateur, il contribue à diminuer la charge des serveurs. Les serveurs peuvent ainsi accueillir plus de visiteurs et dans de meilleures conditions. En outre, les administrateurs Web peuvent diminuer les coûts d'exploitation avec une utilisation plus efficace de la bande passante des serveurs.

Traduction par '''Ldfa''' et '''ricouz''' de l'article de abc@home sur le Forum Officiel.

Base de connaissances de Maxthon 2.0

2008-10-25T14:36:01Z

Ray1 : /* Pour les utilisateurs */

==Vue d'ensemble==
Bienvenue sur la base de connaissances de Maxthon v2.0.
Vous pourrez trouver ici des manuels et des documentations pour Maxthon v2.0.

Si vous n'avez pas encore essayé Maxthon, vous pouvez vous procurer une version de démonstration de Maxthon v2.0 dans la section Beta Test de [http://forum.maxthon.com/index.php?showtopic=46355 notre Forum].

==Pour les utilisateurs==
* [[Les caractéristiques de Maxthon v2.0]]. Nouveau
* [[L’accélérateur de site de Maxthon v2.0]]. Nouveau

==Pour les développeurs==
* [[Les Skins de Maxthon v2.0]]. Nouveau
* [[Les scripts de Maxthon v2.0]]. Nouveau
* [[Les filtres personnalisés de Maxthon v2.0]].
* [[Les listes de Proxy de Maxthon v2.0]]. Nouveau
* [[Les fichiers de configuration de Maxthon v2.0]]. Nouveau

<center>[[Accueil]]</center>

Base de connaissances de Maxthon 2.0

2008-10-25T14:35:27Z

Ray1 : /* Pour les utilisateurs */

==Vue d'ensemble==
Bienvenue sur la base de connaissances de Maxthon v2.0.
Vous pourrez trouver ici des manuels et des documentations pour Maxthon v2.0.

Si vous n'avez pas encore essayé Maxthon, vous pouvez vous procurer une version de démonstration de Maxthon v2.0 dans la section Beta Test de [http://forum.maxthon.com/index.php?showtopic=46355 notre Forum].

==Pour les utilisateurs==
* [[Les caractéristiques de Maxthon v2.0]]. Nouveau
* [[L’accélérateur de site de Maxthon]]. Nouveau

==Pour les développeurs==
* [[Les Skins de Maxthon v2.0]]. Nouveau
* [[Les scripts de Maxthon v2.0]]. Nouveau
* [[Les filtres personnalisés de Maxthon v2.0]].
* [[Les listes de Proxy de Maxthon v2.0]]. Nouveau
* [[Les fichiers de configuration de Maxthon v2.0]]. Nouveau

<center>[[Accueil]]</center>

Introduction à l’accélérateur de site de Maxthon

2008-10-25T14:31:51Z

Ray1 :

== '''Introduction à l’accélérateur de site de Maxthon''' ==

Il y a longtemps que les utilisateurs attendaient la vitesse d'Opera couplée aux fonctionnalités riches de Maxthon. Nous avons activement recherché une solution d'amélioration de la vitesse et le dernier AIM(1) ou MSA(2) en est le résultat, et se compose de plusieurs optimisations basées sur les habitudes générales des utilisateurs, l'efficacité des transmissions réseau, le mécanisme de cache de navigation et l'intelligence d'interprétation du contenu.
(1) AIM : (en français) Accélération Intelligente de Maxthon
(2) MSA : (en anglais) Maxthon Smart Acceleration

'''Actuellement AIM a deux modes d'accélération :'''

* Mode d'accélération par défaut (activé par défaut) lecture rapide sans panne et emploie une approche relativement conservatrice pour une bonne vitesse de navigation sans poser de problème.
* Mode super accélération (activé sur chaque site à partir du bouton en forme d'éclair de la barre d'état) vise une vitesse maximale de navigation et améliorera la vitesse de navigation très sensiblement, particulièrement sur les sites fréquemment visités et avec une faible connectivité.

'''Quand AIM doit être employé et dans quel mode ?'''

Normalement, la majorité des utilisateurs peuvent activer le mode d'accélération par défaut pour une meilleure vitesse de navigation. Pour les utilisateurs qui visitent fréquemment les mêmes sites avec une faible connectivité, ils peuvent utiliser le super mode d'accélération pour ces sites.

'''Quels sont les inconvénients, s'il y en a ?'''

Avec le mode super accélération actif, certaines pages Web peuvent ne pas être toujours mises à jour. Ceci se produit habituellement sur certains sites. Les utilisateurs peuvent sélectivement activer le super mode d'accélération seulement pour les sites qui ne posent pas ce problème.

'''Dans quelles circonstances l'amélioration de la vitesse n'est pas notable ?'''

L'AIM est conçu pour fonctionner le plus efficacement sur des sites Web avec une faible connectivité et fréquemment visités. L'amélioration de la vitesse. Elle peut ne pas être apparente pour des utilisateurs ayant une large bande passante ou visitant la plupart du temps des sites avec une large bande passante. En outre, l'amélioration de vitesse peut ne pas être apparente pour des sites visités peu souvent.

'''Quels sont les avantages de l'AIM pour les administrateurs Web ?'''

Puisque l'AIM assure une utilisation plus efficace de la connexion Internet et du cache du navigateur, il contribue à diminuer la charge des serveurs. Les serveurs peuvent ainsi accueillir plus de visiteurs et dans de meilleures conditions. En outre, les administrateurs Web peuvent diminuer les coûts d'exploitation avec une utilisation plus efficace de la bande passante des serveurs.

Base de connaissances de Maxthon 2.0

2008-10-25T14:24:59Z

Ray1 : /* Pour les utilisateurs */

==Vue d'ensemble==
Bienvenue sur la base de connaissances de Maxthon v2.0.
Vous pourrez trouver ici des manuels et des documentations pour Maxthon v2.0.

Si vous n'avez pas encore essayé Maxthon, vous pouvez vous procurer une version de démonstration de Maxthon v2.0 dans la section Beta Test de [http://forum.maxthon.com/index.php?showtopic=46355 notre Forum].

==Pour les utilisateurs==
* [[Les caractéristiques de Maxthon v2.0]]. Nouveau
* [[Introduction à l’accélérateur de site de Maxthon]]. Nouveau

==Pour les développeurs==
* [[Les Skins de Maxthon v2.0]]. Nouveau
* [[Les scripts de Maxthon v2.0]]. Nouveau
* [[Les filtres personnalisés de Maxthon v2.0]].
* [[Les listes de Proxy de Maxthon v2.0]]. Nouveau
* [[Les fichiers de configuration de Maxthon v2.0]]. Nouveau

<center>[[Accueil]]</center>

Les scripts de Maxthon v2.0

2008-10-04T13:07:09Z

Ray1 : /* '''1. ModuleType - Script, HTML, EXE, COM et COM_Global''' */

== '''Types de Plugin de Maxthon''' ==

Le type de Plugin de Maxthon est défini par ModuleType (Script, HTML, COM et EXE) et Type (Button, Sidebar, Toolbar, COM_Button, MHO, MHO_Button) simultanément :

Button SideBar Toolbar COM_Button MHO MHO_Button
Script oui oui
HTML oui
EXE oui
COM oui oui oui oui oui oui
COM_Global oui oui oui oui

==== '''1. ModuleType - Script, HTML, EXE, COM et COM_Global''' ====

'''Script''' - Le Plugin Script peut être de type button, qui exécute un script lorsqu'il est cliqué. le script peut être dans un langage supporté par IE, comme le JavaScript ou le vbscript. Maxthon 2.0 supporte le mscript qui exécute l'environnement (plus de détails ci-après). Le Script peut également être de type sidebar, qui affiche un fichier HTML dans la barre latérale.

'''HTML''' - Un nouveau type de Plugin pour Maxthon 2.0 seulement. Le Plugin de type HTML est similaire au Plugin Script Sidebar dans sa nature. La différence majeure est que le Plugin Script Sidebar est affiché dans la barre latérale de Maxthon alors que le Plugin HTML est affiché comme un bouton dans la barre des Plugins ou n'importe quelle barre d'outils (barre d'état, barre des menus, barre des onglets, barre d'adresses...).

'''EXE''' - Le Plugin EXE sera affiché comme un bouton sur la barre des Plugins. Le Plugin EXE peut être n'importe quel fichier exécutable. Maxthon peut passer plusieurs paramètres au fichier exécutable comme l'URL de la page Web en cours ou le "handle" de la fenêtre de Maxthon.

'''COM''' - Un plugin Com peut créer une instance de l'interface de IObjectWithSite, faisant passer le pointeur de la page courante de IWebBrowser2 à sa fonction IObjectWithSite::SetSite et appelant ensuite sa fonction IOleCommandTarget::Exec. Ce qui permet d'interagir avec les évènements/opérations/activités du navigateur et le Document Object Model.

'''COM_Global''' - Les Plugins COM_Global sont créés seulement une fois au démarrage de Maxthon, et sont détruits à la fermeture de Maxthon. Les Plugins COM_Global sont souvent pour les fonctions de navigation qui ne sont pas en relation avec le Document Object Model. Ainsi, les Plugins COM_Global peuvent implémenter une fonction PutMaxCommander à travers l'interface IDispatch pour obtenir un objet du Plugin de Maxthon, qui peut être utilisé de la même façon qu'un objet externe de Maxthon pour les Plugins script (cf. les commandes ci-dessous des Plugins script), pour interagir avec le Document Object Model des onglets et Maxthon.

Notez que Maxthon 2.0 est "multithread" (un "thread" pour chaque onglet). Les Plugins développés pour une interaction approfondie avec le Document Object Model des onglets doivent être développés en COM (par onglet) au lieu de COM_Global ainsi ils pourront fonctionner plus efficacement avec le même "thread" d'un onglet individuel.

==== '''2. Type - Button, SideBar, Toolbar, COM_Button, MHO, and MHO_Button''' ====

'''Button''' - Un bouton sera ajouté sur la barre des Plugins. L'opération spécifiée par le script (Plugin Script), l'exécutable (Plugin EXE), la DLL (Plugin COM) sera exécutée lorsque le bouton sera cliqué. En option, Les Plugins de bouton peuvent implémenter un menu déroulant pour le Plugin. Un Plugin de bouton COM doit implémenter l'interface IOleCommandTarget pour recevoir le clic du bouton. Si un menu est implémenté, la fonction IOleCommandTarget_Exec recevra un id de commande de 1 lorsque le bouton est cliqué, et un id de commande de 2 lorsque le premier item du menu est cliqué, et ainsi de suite. Un Plugin de bouton COM est créé lorsque le bouton est cliqué et est détruit lorsque l'onglet est fermé (comme IE7).

'''SideBar''' - Un bouton sera ajouté à la barre latérale, et un élément sera ajouté au menu principal > Affichage > Barre latérale. Lorsque le bouton ou l’élément du menu est cliqué, la barre latérale de Maxthon s'ouvrira et affichera le fichier HTML spécifié par le Plugin (Plugin script), ou la fenêtre spécifiée par le Plugin à travers l'interface IDeskBand (Plugin com ou com_global).

'''Toolbar''' - Les Plugins de barre d'outils doivent être écrits en COM. Une nouvelle barre d'outils sera ajoutée, qui pourra être affichée ou cachée à partir du menu principal > Affichage > Barre d'outils. Un Plugin de barre d'outils doit implémenter l'interface IDeskBand pour spécifier la fenêtre de la barre d'outils. Les Plugins de barre d'outils peuvent être COM ou COM_Global. Les Plugins de barre d'outils COM sont affectés à un onglet lorsque l'onglet est crée, et sont détruits lorsque l'onglet est fermé. Cela permet l'adoption de certaines barres d'outils d'IE dans Maxthon en l'état ou avec un minimum de changements. Les barres d'outils COM_Global sont créés uniquement au démarrage de Maxthon, et sont détruites à la fermeture de Maxthon. Si une barre d'outils COM_Global implémente l'interface IObjectWithSite, elle peut obtenir le pointeur sur webbrowser de l'onglet actif à travers la fonction SetSite. Lorsque l'onglet actif est modifié, SetSite sera appelé de nouveau pour passer le pointeur sur webbrowser du nouvel onglet actif.

'''COM_Button''' - Les Plugins COM_Button sont identiques au Plugins de barre d'outils, à l'exception près que les Plugins COM_Button sont affichés dans Maxthon comme un bouton, et non pas comme une barre d'outils. Un Plugin COM_Button a la même flexibilité de positionnement dans l'interface de Maxthon que les autres boutons, mais il supporte également la richesse de l'interface d'une barre d'outils par rapport à celle d'un simple bouton.

'''MHO''' - Un Plugin MHO est identique au Browser Helper Object d'IE et doit être écrit en COM. Les Plugins MHO sont créés par onglet lorsque l'onglet est créé, et sont détruits lorsque l'onglet est fermé. Les Plugins MHO doivent implémenter l'interface IObjectWithSite pour obtenir un pointeur sur webbrowser de l'onglet pour interagir avec le DOM. Les Plugins MHO n'ont pas d'interface.

'''MHO_Button''' - Le Plugin MHO est une combinaison d'un Plugin MHO et d'un Plugin bouton COM. Les Plugins MHO_Button sont créés par onglet lorsque l'onglet est créé, et sont détruits lorsque l'onglet est fermé. En plus, une instance de Plugin MHO_Button sera créée lorsque son bouton est cliqué, et l'instance sera détruite lorsque l'opération est terminée. Le Plugin MHO_Button ajoute essentiellement une interface bouton au Plugin MHO.

== Créer un Plugin pour Maxthon ==

'''Composants majeurs d’un Plugin de Maxthon'''

Un Plugin de Maxthon contient généralement les fichiers suivants :

'''Fichiers INI''' – Le fichier plugin.ini est nécessaire pour tous les Plugins de Maxthon. Il définit plusieurs attributs du Plugin.

'''Fichiers HTML/DLL/EXE file''' – Le composant principal nécessaire à tous les Plugins de Maxthon spécifiant l'opération à réaliser ou le contenu à afficher.

'''Fichier Icônes''' – L'icône du bouton (*.ICO) nécessaire aux Plugins bouton et barre latérale. Les plugins COM ou EXE peuvent utiliser des icones insérées dans leur code.

'''Config.html''' – Un fichier HTML optionnel pour être utilisé avec les Plugins de type Script et HTML comme boîte de dialogue de configuration.

'''Fichier plugin.ini'''

[General] nécessaire à la définition de plusieurs attributs du plugin

'''Name'''= nom du Plugin

'''Author'''= nom de l'auteur

'''Version'''= Version du Plugin

'''ModuleType'''= Peut être Script, HTML, EXE, COM, or COM_Global

'''FileName'''= Peut-être un fichier HTML (Plugins Script et HTML), un fichier DLL (Plugins COM) ou un fichier EXE (Plugins EXE)

'''Comments'''= La description affichée dans les options du Plugin et/ou l'info-bulle du Plugin de type Button

'''Type'''= Peut être M2Plugin_Button, M2Plugin_Sidebar, M2Plugin_Toolbar, M2Plugin_COM_Button, M2Plugin_MHO, ou M2Plugin_MHO_Button

'''IdealSize'''= La largeur et la hauteur de l'interface du Plugin (ex. 120 20, pour un Plugin HTML seulement)

'''IdealSizeVertical'''= La largeur et la hauteur de l'interface du Plugin lorsqu'il est positionné verticalement (ex 120 20, optionnel pour un Plugin HTML)

'''Icon'''= L'icône du bouton pour les Plugins de type Button ou Sidebar

'''HotIcon'''= L'icône du bouton lorsque le bouton du Plugin est survolé

'''CLSID'''= Le CSLID pour les Plugins de type COM et COM_Global

'''DefaultLocation'''= Optionnel, défini la localisation par défaut de l'icône du Plugin, peut être '''None''' (dans la barre des Plugins, mais non affichée après l'installation, l'utilisateur peut afficher le bouton à partir du menu Afficher ou masquer des boutons), '''MenuBar''', '''ToolBar''', ou '''StatusBar'''. S’il n'est pas définit, le Plugin sera affiché dans la barre des Plugins. Pour le Plugin de type '''Button''' et pour Maxthon 2.0.5 ou supérieur.

'''StartAfterPageDoneURL'''= Optionnel, définit les adresses pour lesquelles le Plugin doit démarrer automatiquement, supporte les caractères joker, et on peut utiliser "|" pour séparer les adresses, ex. '''*maxthon.com*|forum.maxthon.cn*'''. Si il n'est pas défini, le Plugin démarrera pour toutes les adresses, équivalent à '''*'''. Pour les Plugins de types '''Script''' et '''Button''' et pour Maxthon 2.0.5 ou supérieur.

'''StartAfterPageDoneURLExclude'''= Optionnel, définit les adresses pour lesquelles le Plugin ne doit pas démarrer automatiquement, a une priorité supérieure à startAfterPageDoneUrl. Utilise le même format que startAfterPageDoneUrl ex. '''forum.maxthon.cn/index.php?|*.maxthon.cn/index.php?showtopic*'''. Pour les Plugins de types '''Script''' et '''Button''' et pour Maxthon 2.0.5 ou supérieur.

[MyIE2Buttons] Optionnel pour définir le menu déroulant pour les Plugins de types Button et MHO_Button

'''Count'''= Le nombre d'éléments du menu déroulant

'''Name1'''= Le nom du 1er élément du menu déroulant

'''FileName1'''= Le nom du fichier, ou le nom du fichier + les paramètres pour les Plugins de type EXE, du 1er élément du menu déroulant. Pour les Plugins de type COM Button et COM MHO_Button, mettre un nom arbitraire et distinct, ex. 1 pour FileName1 et 2 pour FileName2 etc.

'''Installation d'un Plugin de Maxthon'''

Les Plugins de Maxthon sont installés dans le répertoire "Plugin" du dossier d'installation de Maxthon. Chaque Plugin possède son propre dossier dédié qui contient le fichier plugin.ini et les autres fichiers nécessaires et/ou sous-dossiers.

Un Plugin terminé, comprenant le dossier du Plugin et tous les fichiers et/ou sous-dossiers peut-être compressé dans un fichier ZIP (*.zip) pour être déployé.

'''Maxthon 2.0'''

Maxthon 2.0 supporte un pack d'installation M2P de plugins (essentiellement un *.zip renommé en *.m2p. Le Plugin sera installé lorsque le fichier M2P est double-cliqué ou par glisser/déplacer dans la fenêtre de Maxthon.

'''Maxthon 1.X'''

Les Plugins sont installés dans Maxthon 1.x en suivant cette procédure :

1. Fermer Maxthon

2. Extraire le fichier zip du Plugin dans le dossier "Plugin" du répertoire d'installation de Maxthon. En général, le fichier plugin.ini devrait se trouver dans C:\Program Files\Maxthon\Plugin\'''NewPlugin'''\plugin.ini

3. Ouvrir Maxthon, la fenêtre d'installation du Plugin devrait s'afficher

4. Confirmer l'installation du nouveau plugin

== Commandes des Plugins Script de Maxthon ==

Maxthon propose plusieurs commandes pour améliorer la capacité des Plugins Script. Ces commandes peuvent être exécutées par l'intermédiaire de l'objet window.external. Certaines commandes nécessitent un ID de sécurité généré par Maxthon pour pouvoir s'exécuter.

'''Comment obtenir l'ID de sécurité'''

1. Les Plugins Script de type Button peuvent utiliser "%max_security_id" pour l'ID de sécurité

2. Les Plugins Script de type Sidebar et les Plugins HTML de type Button doivent charger "max.src", un script généré par Maxthon. Ensuite "max_security_id" peut être utilisé :

<script src=max.src></script>

'''Référence des commandes des Plugins de Maxthon'''

Sauf indication contraire, les commandes suivantes sont applicables pour Maxthon 2.0 et Maxthon 1.X :

1. '''max_version''' - retourne le numéro de version de Maxthon

Exemple :
alert(external.max_version);

2. '''max_language_id''' - retourne l'ID de langue de Maxthon

Exemple :
alert(external.max_language_id);

Note : Maxthon 2.0 et Maxthon 1.X ont un format d'ID de langue différent

3. '''tab_count''' - retourne le nombre d'onglets ouverts dans Maxthon

Exemple :
alert(external.tab_count);

4. '''cur_sel''' - retourne l'index de l'onglet en cours de Maxthon

Exemple :
alert(external.cur_sel);

5. '''m2_plugin_folder( security_id , plugin_name )''' - retourne le chemin du dossier du Plugin spécifié

Exemple :
alert(external.m2_plugin_folder( %max_security_id , 'ViewSource!'));

6. '''m2_run_cmd( security_id , command_id )''' - exécute l'ID de la commande spécifiée

Exemple :
external. m2_run_cmd( %max_security_id , 32772 ));

Note: Maxthon 2.0 et Maxthon 1.X ont des ID de commande différents. Les ID des commandes se trouvent dans le fichier langue de Maxthon.

7. '''get_tab( security_id , tab_index )''' - retourne l'objet Windows de l'onglet spécifié

Exemple :
var oWin=external.get_tab(%max_security_id, 0);
alert(oWin.document.URL);

8. '''activate_tab( security_id , tab_index )''' - active l'onglet spécifié

Exemple :
external.activate_tab(%max_security_id, 0);

9. '''close_tab( security_id , tab_index )''' - ferme l'onglet spécifié

Exemple :
external.close_tab(%max_security_id, 0);

10. '''readFile( security_id, plugin_name, file_name)''' - lit le contenu du fichier texte spécifié

Example :
var sText=external.readFile(%max_security_id, 'ViewPage', 'readme.txt');
alert(sText);

11. '''writeFile( security_id, plugin_name, file_name, content )''' - écrit le contenu dans le fichier texte spécifié

Exemple :
external.writeFile(%max_security_id, 'ViewPage', 'test.txt', 'Ceci est le contenu du fichier');

12. '''m2_readIni( security_id, plugin_name , file_name , section_name , key , default_value)''' - lit les données du fichier INI spécifié

Exemple :
var sDownloadTool=external.m2_readIni(%max_security_id, 'ViewPage', 'plugin.ini', 'Settings', 'Tool', '');
alert(sDownloadTool);

13. '''m2_writeIni( security_id , plugin_name , file_name , section_name , key , value )''' - écrit les données dans le fichier INI spécifié

Exemple :
external.m2_writeIni(%max_security_id, 'ViewPage', 'test.ini', 'Config', 'height', '100px');

14. '''max_modelessDialog( security_id , url , option , attr , window )''' - retourne une page de dialogue en mode Web

Exemple :
var oDialog= external.max_modelessDialog( %max_security_id , 'blank.html', window , '', window );
var oDoc=oDialog.document;
oDoc.write('Testing');
oDoc.close();

15. '''max_activex(security_id ,program_id)''' - retourne l'objet ActiveX spécifié

Exemple :
var oWSH=external.max_activex(%max_security_id, 'WScript.Shell');
oWSH.run('notepad.exe');

16. '''m2_search_text(security_id)''' - retourne le texte de la barre de recherche

Exemple :
alert(m2_search_text(%max_security_id));

17. '''max_callback(event_name)''' - une fonction qui est exécutée lorsque certains événements de Maxthon se produisent (pour les Plugins HTML de type Button et les Plugins Script de type Sidebar)

Les Plugins HTML de type Button et les Plugins Script de type Sidebar peuvent utiliser la fonction max_callback pour réagir à certains événements de Maxthon comme le changement d'onglet.

Exemple :
function max_callback(x){
if(x=='tab_change') alert('L'onglet en cours a changé.');
}

En testant le paramètre de la fonction max_callback, le Plugin peut récupérer les événements suivants :

'''Plugins HTML de type Button'''

'''tab_change''' – après que l'onglet en cours ait changé

'''document_Complete''' - après que l'onglet en cours soit entièrement chargé

'''self_destroy''' - lorsque le HTML est déchargé, normalement lorsque Maxthon est fermé

'''Plugins Script de type Sidebar'''

'''sidebar_tab_change''' - après changement de l'onglet actif

'''sidebar_activate''' - lorsque le Plugin Sidebar est activé

'''sidebar_deactivate''' - lorsque le Plugin Sidebar est désactivé

'''sidebar_unload''' - lorsque le Plugin Sidebar est déchargé (Maxthon est fermé)

18. '''max_getObj''' (pour Maxthon 2.0 seulement) - retourne plusieurs objets de Maxthon :

'''Info''' - information générale sur Maxthon

'''Adhunter''' – à propos du tueur de pubs

'''FavManager''' – à propos des Favoris

'''RssManager''' – à propos des flux RSS

'''PluginManager''' - à propos des Plugins, pour Maxthon 2.0.5 ou supérieur

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');

'''L'objet Info supporte les propriétés et méthodes suivantes :'''

Propriétés :

'''fileProxy''' - en lecture seule, retourne le chemin du document de configuration du Proxy utilisateur en cours.

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo.fileProxy);

'''folderUser''' - en lecture seule, retourne le chemin du dossier du profil de l'utilisateur en cours

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo. folderUser);

Méthodes :

'''getFolderPluginData(plugin_name)''' - obtient le chemin du dossier de stockage des données d'un Plugin pour l'utilisateur en cours et le Plugin indiqué

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo.getFolderPluginData('ViewSource!'));

'''L'object AdHunter supporte les méthodes suivantes :'''

Méthodes :

'''reloadFilter(filter_name)''' – recharge le filtre de Maxthon spécifié (actuellement seulement les filtres de contenu) après avoir modifié le filtre en question

Exemple :
var oAdHunter=external.max_getObj(%max_security_id, 'AdHunter');
oAdHunter.reloadFilter('content');

'''enableFilter(filter_name, bEnable)''' – active ou désactive le filtre de 'contenu' ou de 'Popup' de Maxthon

Exemple :
var oAdHunter=external.max_getObj(%max_security_id, 'AdHunter');
oAdHunter.enableFilter ('content', false);

'''L'objet PluginManager supporte les méthodes suivantes :'''

'''getPluginFolder''' - retourne le chemin du dossier principal du Plugin de Maxthon

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getPluginFolder)

'''getCount''' - retourne le total de tous les Plugins installés, qu'ils soient activés ou non

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getCount)

'''getList''' - retourne une liste qui contient des informations comme le nom, l'auteur, etc. de tous les Plugins

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getList)

'''getPlugin(Index)''' - Index est un nombre, retourne les objets du Plugin correspondant

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
var oPlugin=oPluginManager.getPlugin(0);

'''L'objet Plugin retourné de getPlugin(Index) supporte les propriétés et méthodes suivantes :'''

Propriétés :

'''title''' - lecture seule, retourne le nom du Plugin

Exemple :
alert(oPlugin.title);

'''folderName''' - lecture seule, retourne le nom du dossier du Plugin

Exemple :
alert(oPlugin.folderName);

'''fullPath''' - lecture seule, retourne le chemin complet du dossier du Plugin

Exemple :
alert(oPlugin.fullPath);

'''enable''' - lecture/écriture, retourne ou définit si le Plugin est actif

Exemple :
oPlugin.enable=false;
alert(oPlugin.enable);
oPlugin.enable=true;
alert(oPlugin.enable);

'''startAfterPageDone''' - lecture/écriture, retourne ou définit si le Plugin est en démarrage automatique

Exemple :
oPlugin.startAfterPageDone = true;
alert(oPlugin.startAfterPageDone);
oPlugin.startAfterPageDone = false;
alert(oPlugin.startAfterPageDone);

'''startAfterPageDoneUrl''' - lecture/écriture, retourne ou définit l'adresse pour laquelle le Plugin sera démarré automatiquement

Exemple :
oPlugin.startAfterPageDoneUrl='*maxthon.com*|*maxthon.cn*';
alert(oPlugin.startAfterPageDoneUrl);

Mêthodes :

'''config()''' - ouvre la boîte de dialogue de configuration du Plugin (config.html)

Exemple :
oPlugin.config();

'''remove()''' - supprime le Plugin

Exemple :
oPlugin.remove();

== Mscript ==

Maxthon 2.0 supporte des mscripts personnalisés en plus des scripts pour les Plugins de type Button. Contrairement aux scripts normaux, les mscripts ne sont pas exécutés sur des pages Web ,ainsi les mscripts ne sont pas sujets aux restrictions de sécurité imposées aux scripts normaux,et on ne doit donc pas craindre qu'ils soient exploités par des pages Web. Les mscripts peuvent grandement améliorer les fonctionnalités des Plugins car ils peuvent fonctionner malgré la désactivation des scripts classiques et aussi accéder aux contenus des différentes frames d'une page web même si elles ne sont pas dans le même domaine.
Pour utiliser mscript dans un Plugin de type Button, remplacez la balise <script...> par <mscript...>

Exemple - le Plugin de type Button peut désactiver les scripts dans la page en cours en modifiant le contrôle de contenu de Maxthon :

<script language="javascript">
external.m2_run_cmd(%max_security_id, 33175);
</script>

Mais après que les scripts aient été désactivés, le Plugin ne peut plus fonctionner. Ainsi, il ne pourra plus réactiver les scripts dans la page en cours. Au contraire, le Plugin mscript suivant peut fonctionner avec les scripts désactivés, ainsi il pourra réactiver les scripts dans la page en cours.

<mscript language="javascript">
external.m2_run_cmd(0, 33175);
</script>

Notez qu'un nombre arbitraire peut être utilisé comme %max_security_id lorsque le mscript est utilisé.

<center>[[Base de connaissances de Maxthon 2.0]]</center>

Les scripts de Maxthon v2.0

2008-10-04T13:01:44Z

Ray1 : /* '''1. ModuleType - Script, HTML, EXE, COM et COM_Global''' */

== '''Types de Plugin de Maxthon''' ==

Le type de Plugin de Maxthon est défini par ModuleType (Script, HTML, COM et EXE) et Type (Button, Sidebar, Toolbar, COM_Button, MHO, MHO_Button) simultanément :

Button SideBar Toolbar COM_Button MHO MHO_Button
Script oui oui
HTML oui
EXE oui
COM oui oui oui oui oui oui
COM_Global oui oui oui oui

==== '''1. ModuleType - Script, HTML, EXE, COM et COM_Global''' ====

'''Script''' - Le Plugin Script peut être de type button, qui exécute un script lorsqu'il est cliqué. le script peut être dans un langage supporté par IE, comme le JavaScript ou le vbscript. Maxthon 2.0 supporte le mscript qui exécute l'environnement (plus de détails ci-après). Le Script peut également être de type sidebar, qui affiche un fichier HTML dans la barre latérale.

'''HTML''' - Un nouveau type de Plugin pour Maxthon 2.0 seulement. Le Plugin de type HTML est similaire au Plugin Script Sidebar dans sa nature. La différence majeure est que le Plugin Script Sidebar est affiché dans la barre latérale de Maxthon alors que le Plugin HTML est affiché comme un bouton dans la barre des Plugins ou n'importe quelle barre d'outils (barre d'état, barre des menus, barre des onglets, barre d'adresses...).

'''EXE''' - Le Plugin EXE sera affiché comme un bouton sur la barre des Plugins. Le Plugin EXE peut être n'importe quel fichier exécutable. Maxthon peut passer plusieurs paramètres au fichier exécutable comme l'URL de la page Web en cours ou le "handle" de la fenêtre de Maxthon.

'''COM''' - Un plugin Com peut créer une intance de l'interface de IObjectWithSite, faisant passer le pointeur de la page courante de IWebBrowser2 à sa fonction IObjectWithSite::SetSite et appelant ensuite sa fonction IOleCommandTarget::Exec. Ce qui permet d'interagir avec les évènements/opérations/activités du navigateur et le Document Object Model.

'''COM_Global''' - Les Plugins COM_Global sont créés seulement une fois au démarrage de Maxthon, et sont détruits à la fermeture de Maxthon. Les Plugins COM_Global sont souvent pour les fonctions de navigation qui ne sont pas en relation avec le Document Object Model. Ainsi, les Plugins COM_Global peuvent implémenter une fonction PutMaxCommander à travers l'interface IDispatch pour obtenir un objet du Plugin de Maxthon, qui peut être utilisé de la même façon qu'un objet externe de Maxthon pour les Plugins script (cf. les commandes ci-dessous des Plugins script), pour interagir avec le Document Object Model des onglets et Maxthon.

Notez que Maxthon 2.0 est "multithread" (un "thread" pour chaque onglet). Les Plugins développés pour une interaction approfondie avec le Document Object Model des onglets doivent être développés en COM (par onglet) au lieu de COM_Global ainsi ils pourront fonctionner plus efficacement avec le même "thread" d'un onglet individuel.

==== '''2. Type - Button, SideBar, Toolbar, COM_Button, MHO, and MHO_Button''' ====

'''Button''' - Un bouton sera ajouté sur la barre des Plugins. L'opération spécifiée par le script (Plugin Script), l'exécutable (Plugin EXE), la DLL (Plugin COM) sera exécutée lorsque le bouton sera cliqué. En option, Les Plugins de bouton peuvent implémenter un menu déroulant pour le Plugin. Un Plugin de bouton COM doit implémenter l'interface IOleCommandTarget pour recevoir le clic du bouton. Si un menu est implémenté, la fonction IOleCommandTarget_Exec recevra un id de commande de 1 lorsque le bouton est cliqué, et un id de commande de 2 lorsque le premier item du menu est cliqué, et ainsi de suite. Un Plugin de bouton COM est créé lorsque le bouton est cliqué et est détruit lorsque l'onglet est fermé (comme IE7).

'''SideBar''' - Un bouton sera ajouté à la barre latérale, et un élément sera ajouté au menu principal > Affichage > Barre latérale. Lorsque le bouton ou l’élément du menu est cliqué, la barre latérale de Maxthon s'ouvrira et affichera le fichier HTML spécifié par le Plugin (Plugin script), ou la fenêtre spécifiée par le Plugin à travers l'interface IDeskBand (Plugin com ou com_global).

'''Toolbar''' - Les Plugins de barre d'outils doivent être écrits en COM. Une nouvelle barre d'outils sera ajoutée, qui pourra être affichée ou cachée à partir du menu principal > Affichage > Barre d'outils. Un Plugin de barre d'outils doit implémenter l'interface IDeskBand pour spécifier la fenêtre de la barre d'outils. Les Plugins de barre d'outils peuvent être COM ou COM_Global. Les Plugins de barre d'outils COM sont affectés à un onglet lorsque l'onglet est crée, et sont détruits lorsque l'onglet est fermé. Cela permet l'adoption de certaines barres d'outils d'IE dans Maxthon en l'état ou avec un minimum de changements. Les barres d'outils COM_Global sont créés uniquement au démarrage de Maxthon, et sont détruites à la fermeture de Maxthon. Si une barre d'outils COM_Global implémente l'interface IObjectWithSite, elle peut obtenir le pointeur sur webbrowser de l'onglet actif à travers la fonction SetSite. Lorsque l'onglet actif est modifié, SetSite sera appelé de nouveau pour passer le pointeur sur webbrowser du nouvel onglet actif.

'''COM_Button''' - Les Plugins COM_Button sont identiques au Plugins de barre d'outils, à l'exception près que les Plugins COM_Button sont affichés dans Maxthon comme un bouton, et non pas comme une barre d'outils. Un Plugin COM_Button a la même flexibilité de positionnement dans l'interface de Maxthon que les autres boutons, mais il supporte également la richesse de l'interface d'une barre d'outils par rapport à celle d'un simple bouton.

'''MHO''' - Un Plugin MHO est identique au Browser Helper Object d'IE et doit être écrit en COM. Les Plugins MHO sont créés par onglet lorsque l'onglet est créé, et sont détruits lorsque l'onglet est fermé. Les Plugins MHO doivent implémenter l'interface IObjectWithSite pour obtenir un pointeur sur webbrowser de l'onglet pour interagir avec le DOM. Les Plugins MHO n'ont pas d'interface.

'''MHO_Button''' - Le Plugin MHO est une combinaison d'un Plugin MHO et d'un Plugin bouton COM. Les Plugins MHO_Button sont créés par onglet lorsque l'onglet est créé, et sont détruits lorsque l'onglet est fermé. En plus, une instance de Plugin MHO_Button sera créée lorsque son bouton est cliqué, et l'instance sera détruite lorsque l'opération est terminée. Le Plugin MHO_Button ajoute essentiellement une interface bouton au Plugin MHO.

== Créer un Plugin pour Maxthon ==

'''Composants majeurs d’un Plugin de Maxthon'''

Un Plugin de Maxthon contient généralement les fichiers suivants :

'''Fichiers INI''' – Le fichier plugin.ini est nécessaire pour tous les Plugins de Maxthon. Il définit plusieurs attributs du Plugin.

'''Fichiers HTML/DLL/EXE file''' – Le composant principal nécessaire à tous les Plugins de Maxthon spécifiant l'opération à réaliser ou le contenu à afficher.

'''Fichier Icônes''' – L'icône du bouton (*.ICO) nécessaire aux Plugins bouton et barre latérale. Les plugins COM ou EXE peuvent utiliser des icones insérées dans leur code.

'''Config.html''' – Un fichier HTML optionnel pour être utilisé avec les Plugins de type Script et HTML comme boîte de dialogue de configuration.

'''Fichier plugin.ini'''

[General] nécessaire à la définition de plusieurs attributs du plugin

'''Name'''= nom du Plugin

'''Author'''= nom de l'auteur

'''Version'''= Version du Plugin

'''ModuleType'''= Peut être Script, HTML, EXE, COM, or COM_Global

'''FileName'''= Peut-être un fichier HTML (Plugins Script et HTML), un fichier DLL (Plugins COM) ou un fichier EXE (Plugins EXE)

'''Comments'''= La description affichée dans les options du Plugin et/ou l'info-bulle du Plugin de type Button

'''Type'''= Peut être M2Plugin_Button, M2Plugin_Sidebar, M2Plugin_Toolbar, M2Plugin_COM_Button, M2Plugin_MHO, ou M2Plugin_MHO_Button

'''IdealSize'''= La largeur et la hauteur de l'interface du Plugin (ex. 120 20, pour un Plugin HTML seulement)

'''IdealSizeVertical'''= La largeur et la hauteur de l'interface du Plugin lorsqu'il est positionné verticalement (ex 120 20, optionnel pour un Plugin HTML)

'''Icon'''= L'icône du bouton pour les Plugins de type Button ou Sidebar

'''HotIcon'''= L'icône du bouton lorsque le bouton du Plugin est survolé

'''CLSID'''= Le CSLID pour les Plugins de type COM et COM_Global

'''DefaultLocation'''= Optionnel, défini la localisation par défaut de l'icône du Plugin, peut être '''None''' (dans la barre des Plugins, mais non affichée après l'installation, l'utilisateur peut afficher le bouton à partir du menu Afficher ou masquer des boutons), '''MenuBar''', '''ToolBar''', ou '''StatusBar'''. S’il n'est pas définit, le Plugin sera affiché dans la barre des Plugins. Pour le Plugin de type '''Button''' et pour Maxthon 2.0.5 ou supérieur.

'''StartAfterPageDoneURL'''= Optionnel, définit les adresses pour lesquelles le Plugin doit démarrer automatiquement, supporte les caractères joker, et on peut utiliser "|" pour séparer les adresses, ex. '''*maxthon.com*|forum.maxthon.cn*'''. Si il n'est pas défini, le Plugin démarrera pour toutes les adresses, équivalent à '''*'''. Pour les Plugins de types '''Script''' et '''Button''' et pour Maxthon 2.0.5 ou supérieur.

'''StartAfterPageDoneURLExclude'''= Optionnel, définit les adresses pour lesquelles le Plugin ne doit pas démarrer automatiquement, a une priorité supérieure à startAfterPageDoneUrl. Utilise le même format que startAfterPageDoneUrl ex. '''forum.maxthon.cn/index.php?|*.maxthon.cn/index.php?showtopic*'''. Pour les Plugins de types '''Script''' et '''Button''' et pour Maxthon 2.0.5 ou supérieur.

[MyIE2Buttons] Optionnel pour définir le menu déroulant pour les Plugins de types Button et MHO_Button

'''Count'''= Le nombre d'éléments du menu déroulant

'''Name1'''= Le nom du 1er élément du menu déroulant

'''FileName1'''= Le nom du fichier, ou le nom du fichier + les paramètres pour les Plugins de type EXE, du 1er élément du menu déroulant. Pour les Plugins de type COM Button et COM MHO_Button, mettre un nom arbitraire et distinct, ex. 1 pour FileName1 et 2 pour FileName2 etc.

'''Installation d'un Plugin de Maxthon'''

Les Plugins de Maxthon sont installés dans le répertoire "Plugin" du dossier d'installation de Maxthon. Chaque Plugin possède son propre dossier dédié qui contient le fichier plugin.ini et les autres fichiers nécessaires et/ou sous-dossiers.

Un Plugin terminé, comprenant le dossier du Plugin et tous les fichiers et/ou sous-dossiers peut-être compressé dans un fichier ZIP (*.zip) pour être déployé.

'''Maxthon 2.0'''

Maxthon 2.0 supporte un pack d'installation M2P de plugins (essentiellement un *.zip renommé en *.m2p. Le Plugin sera installé lorsque le fichier M2P est double-cliqué ou par glisser/déplacer dans la fenêtre de Maxthon.

'''Maxthon 1.X'''

Les Plugins sont installés dans Maxthon 1.x en suivant cette procédure :

1. Fermer Maxthon

2. Extraire le fichier zip du Plugin dans le dossier "Plugin" du répertoire d'installation de Maxthon. En général, le fichier plugin.ini devrait se trouver dans C:\Program Files\Maxthon\Plugin\'''NewPlugin'''\plugin.ini

3. Ouvrir Maxthon, la fenêtre d'installation du Plugin devrait s'afficher

4. Confirmer l'installation du nouveau plugin

== Commandes des Plugins Script de Maxthon ==

Maxthon propose plusieurs commandes pour améliorer la capacité des Plugins Script. Ces commandes peuvent être exécutées par l'intermédiaire de l'objet window.external. Certaines commandes nécessitent un ID de sécurité généré par Maxthon pour pouvoir s'exécuter.

'''Comment obtenir l'ID de sécurité'''

1. Les Plugins Script de type Button peuvent utiliser "%max_security_id" pour l'ID de sécurité

2. Les Plugins Script de type Sidebar et les Plugins HTML de type Button doivent charger "max.src", un script généré par Maxthon. Ensuite "max_security_id" peut être utilisé :

<script src=max.src></script>

'''Référence des commandes des Plugins de Maxthon'''

Sauf indication contraire, les commandes suivantes sont applicables pour Maxthon 2.0 et Maxthon 1.X :

1. '''max_version''' - retourne le numéro de version de Maxthon

Exemple :
alert(external.max_version);

2. '''max_language_id''' - retourne l'ID de langue de Maxthon

Exemple :
alert(external.max_language_id);

Note : Maxthon 2.0 et Maxthon 1.X ont un format d'ID de langue différent

3. '''tab_count''' - retourne le nombre d'onglets ouverts dans Maxthon

Exemple :
alert(external.tab_count);

4. '''cur_sel''' - retourne l'index de l'onglet en cours de Maxthon

Exemple :
alert(external.cur_sel);

5. '''m2_plugin_folder( security_id , plugin_name )''' - retourne le chemin du dossier du Plugin spécifié

Exemple :
alert(external.m2_plugin_folder( %max_security_id , 'ViewSource!'));

6. '''m2_run_cmd( security_id , command_id )''' - exécute l'ID de la commande spécifiée

Exemple :
external. m2_run_cmd( %max_security_id , 32772 ));

Note: Maxthon 2.0 et Maxthon 1.X ont des ID de commande différents. Les ID des commandes se trouvent dans le fichier langue de Maxthon.

7. '''get_tab( security_id , tab_index )''' - retourne l'objet Windows de l'onglet spécifié

Exemple :
var oWin=external.get_tab(%max_security_id, 0);
alert(oWin.document.URL);

8. '''activate_tab( security_id , tab_index )''' - active l'onglet spécifié

Exemple :
external.activate_tab(%max_security_id, 0);

9. '''close_tab( security_id , tab_index )''' - ferme l'onglet spécifié

Exemple :
external.close_tab(%max_security_id, 0);

10. '''readFile( security_id, plugin_name, file_name)''' - lit le contenu du fichier texte spécifié

Example :
var sText=external.readFile(%max_security_id, 'ViewPage', 'readme.txt');
alert(sText);

11. '''writeFile( security_id, plugin_name, file_name, content )''' - écrit le contenu dans le fichier texte spécifié

Exemple :
external.writeFile(%max_security_id, 'ViewPage', 'test.txt', 'Ceci est le contenu du fichier');

12. '''m2_readIni( security_id, plugin_name , file_name , section_name , key , default_value)''' - lit les données du fichier INI spécifié

Exemple :
var sDownloadTool=external.m2_readIni(%max_security_id, 'ViewPage', 'plugin.ini', 'Settings', 'Tool', '');
alert(sDownloadTool);

13. '''m2_writeIni( security_id , plugin_name , file_name , section_name , key , value )''' - écrit les données dans le fichier INI spécifié

Exemple :
external.m2_writeIni(%max_security_id, 'ViewPage', 'test.ini', 'Config', 'height', '100px');

14. '''max_modelessDialog( security_id , url , option , attr , window )''' - retourne une page de dialogue en mode Web

Exemple :
var oDialog= external.max_modelessDialog( %max_security_id , 'blank.html', window , '', window );
var oDoc=oDialog.document;
oDoc.write('Testing');
oDoc.close();

15. '''max_activex(security_id ,program_id)''' - retourne l'objet ActiveX spécifié

Exemple :
var oWSH=external.max_activex(%max_security_id, 'WScript.Shell');
oWSH.run('notepad.exe');

16. '''m2_search_text(security_id)''' - retourne le texte de la barre de recherche

Exemple :
alert(m2_search_text(%max_security_id));

17. '''max_callback(event_name)''' - une fonction qui est exécutée lorsque certains événements de Maxthon se produisent (pour les Plugins HTML de type Button et les Plugins Script de type Sidebar)

Les Plugins HTML de type Button et les Plugins Script de type Sidebar peuvent utiliser la fonction max_callback pour réagir à certains événements de Maxthon comme le changement d'onglet.

Exemple :
function max_callback(x){
if(x=='tab_change') alert('L'onglet en cours a changé.');
}

En testant le paramètre de la fonction max_callback, le Plugin peut récupérer les événements suivants :

'''Plugins HTML de type Button'''

'''tab_change''' – après que l'onglet en cours ait changé

'''document_Complete''' - après que l'onglet en cours soit entièrement chargé

'''self_destroy''' - lorsque le HTML est déchargé, normalement lorsque Maxthon est fermé

'''Plugins Script de type Sidebar'''

'''sidebar_tab_change''' - après changement de l'onglet actif

'''sidebar_activate''' - lorsque le Plugin Sidebar est activé

'''sidebar_deactivate''' - lorsque le Plugin Sidebar est désactivé

'''sidebar_unload''' - lorsque le Plugin Sidebar est déchargé (Maxthon est fermé)

18. '''max_getObj''' (pour Maxthon 2.0 seulement) - retourne plusieurs objets de Maxthon :

'''Info''' - information générale sur Maxthon

'''Adhunter''' – à propos du tueur de pubs

'''FavManager''' – à propos des Favoris

'''RssManager''' – à propos des flux RSS

'''PluginManager''' - à propos des Plugins, pour Maxthon 2.0.5 ou supérieur

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');

'''L'objet Info supporte les propriétés et méthodes suivantes :'''

Propriétés :

'''fileProxy''' - en lecture seule, retourne le chemin du document de configuration du Proxy utilisateur en cours.

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo.fileProxy);

'''folderUser''' - en lecture seule, retourne le chemin du dossier du profil de l'utilisateur en cours

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo. folderUser);

Méthodes :

'''getFolderPluginData(plugin_name)''' - obtient le chemin du dossier de stockage des données d'un Plugin pour l'utilisateur en cours et le Plugin indiqué

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo.getFolderPluginData('ViewSource!'));

'''L'object AdHunter supporte les méthodes suivantes :'''

Méthodes :

'''reloadFilter(filter_name)''' – recharge le filtre de Maxthon spécifié (actuellement seulement les filtres de contenu) après avoir modifié le filtre en question

Exemple :
var oAdHunter=external.max_getObj(%max_security_id, 'AdHunter');
oAdHunter.reloadFilter('content');

'''enableFilter(filter_name, bEnable)''' – active ou désactive le filtre de 'contenu' ou de 'Popup' de Maxthon

Exemple :
var oAdHunter=external.max_getObj(%max_security_id, 'AdHunter');
oAdHunter.enableFilter ('content', false);

'''L'objet PluginManager supporte les méthodes suivantes :'''

'''getPluginFolder''' - retourne le chemin du dossier principal du Plugin de Maxthon

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getPluginFolder)

'''getCount''' - retourne le total de tous les Plugins installés, qu'ils soient activés ou non

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getCount)

'''getList''' - retourne une liste qui contient des informations comme le nom, l'auteur, etc. de tous les Plugins

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getList)

'''getPlugin(Index)''' - Index est un nombre, retourne les objets du Plugin correspondant

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
var oPlugin=oPluginManager.getPlugin(0);

'''L'objet Plugin retourné de getPlugin(Index) supporte les propriétés et méthodes suivantes :'''

Propriétés :

'''title''' - lecture seule, retourne le nom du Plugin

Exemple :
alert(oPlugin.title);

'''folderName''' - lecture seule, retourne le nom du dossier du Plugin

Exemple :
alert(oPlugin.folderName);

'''fullPath''' - lecture seule, retourne le chemin complet du dossier du Plugin

Exemple :
alert(oPlugin.fullPath);

'''enable''' - lecture/écriture, retourne ou définit si le Plugin est actif

Exemple :
oPlugin.enable=false;
alert(oPlugin.enable);
oPlugin.enable=true;
alert(oPlugin.enable);

'''startAfterPageDone''' - lecture/écriture, retourne ou définit si le Plugin est en démarrage automatique

Exemple :
oPlugin.startAfterPageDone = true;
alert(oPlugin.startAfterPageDone);
oPlugin.startAfterPageDone = false;
alert(oPlugin.startAfterPageDone);

'''startAfterPageDoneUrl''' - lecture/écriture, retourne ou définit l'adresse pour laquelle le Plugin sera démarré automatiquement

Exemple :
oPlugin.startAfterPageDoneUrl='*maxthon.com*|*maxthon.cn*';
alert(oPlugin.startAfterPageDoneUrl);

Mêthodes :

'''config()''' - ouvre la boîte de dialogue de configuration du Plugin (config.html)

Exemple :
oPlugin.config();

'''remove()''' - supprime le Plugin

Exemple :
oPlugin.remove();

== Mscript ==

Maxthon 2.0 supporte des mscripts personnalisés en plus des scripts pour les Plugins de type Button. Contrairement aux scripts normaux, les mscripts ne sont pas exécutés sur des pages Web ,ainsi les mscripts ne sont pas sujets aux restrictions de sécurité imposées aux scripts normaux,et on ne doit donc pas craindre qu'ils soient exploités par des pages Web. Les mscripts peuvent grandement améliorer les fonctionnalités des Plugins car ils peuvent fonctionner malgré la désactivation des scripts classiques et aussi accéder aux contenus des différentes frames d'une page web même si elles ne sont pas dans le même domaine.
Pour utiliser mscript dans un Plugin de type Button, remplacez la balise <script...> par <mscript...>

Exemple - le Plugin de type Button peut désactiver les scripts dans la page en cours en modifiant le contrôle de contenu de Maxthon :

<script language="javascript">
external.m2_run_cmd(%max_security_id, 33175);
</script>

Mais après que les scripts aient été désactivés, le Plugin ne peut plus fonctionner. Ainsi, il ne pourra plus réactiver les scripts dans la page en cours. Au contraire, le Plugin mscript suivant peut fonctionner avec les scripts désactivés, ainsi il pourra réactiver les scripts dans la page en cours.

<mscript language="javascript">
external.m2_run_cmd(0, 33175);
</script>

Notez qu'un nombre arbitraire peut être utilisé comme %max_security_id lorsque le mscript est utilisé.

<center>[[Base de connaissances de Maxthon 2.0]]</center>

Les scripts de Maxthon v2.0

2008-10-02T13:06:06Z

Ray1 : /* Mscript */

== '''Types de Plugin de Maxthon''' ==

Le type de Plugin de Maxthon est défini par ModuleType (Script, HTML, COM et EXE) et Type (Button, Sidebar, Toolbar, COM_Button, MHO, MHO_Button) simultanément :

Button SideBar Toolbar COM_Button MHO MHO_Button
Script oui oui
HTML oui
EXE oui
COM oui oui oui oui oui oui
COM_Global oui oui oui oui

==== '''1. ModuleType - Script, HTML, EXE, COM et COM_Global''' ====

'''Script''' - Le Plugin Script peut être de type button, qui exécute un script lorsqu'il est cliqué. le script peut être dans un langage supporté par IE, comme le JavaScript ou le vbscript. Maxthon 2.0 supporte le mscript qui exécute l'environnement (plus de détails ci-après). Le Script peut également être de type sidebar, qui affiche un fichier HTML dans la barre latérale.

'''HTML''' - Un nouveau type de Plugin pour Maxthon 2.0 seulement. Le Plugin de type HTML est similaire au Plugin Script Sidebar dans sa nature. La différence majeure est que le Plugin Script Sidebar est affiché dans la barre latérale de Maxthon alors que le Plugin HTML est affiché comme un bouton dans la barre des Plugins ou n'importe quelle barre d'outils (barre d'état, barre des menus, barre des onglets, barre d'adresses...).

'''EXE''' - Le Plugin EXE sera affiché comme un bouton sur la barre des Plugins. Le Plugin EXE peut être n'importe quel fichier exécutable. Maxthon peut passer plusieurs paramètres au fichier exécutable comme l'URL de la page Web en cours ou le "handle" de la fenêtre de Maxthon.

'''COM''' - Le Plugin COM peut-être écrit en n'importe quel langage de programmation supporté par MSCOM, comme C++, Delphi, Visual Basic, C# etc. Les Plugins COM sont créés par onglet lors de la création d'un onglet (Types SideBar/Toolbar/MHO/COM_Button) ou lorsque le bouton du Plugin est cliqué (Type Button), et est détruit lorsque l'onglet est fermé. Un Plugin COM peut implémenter l'interface IObjectWithSite pour obtenir le pointeur "webbrowser" de l'onglet, l'événement du navigateur et le Document Object Model pour le manipuler.

'''COM_Global''' - Les Plugins COM_Global sont créés seulement une fois au démarrage de Maxthon, et sont détruits à la fermeture de Maxthon. Les Plugins COM_Global sont souvent pour les fonctions de navigation qui ne sont pas en relation avec le Document Object Model. Ainsi, les Plugins COM_Global peuvent implémenter une fonction PutMaxCommander à travers l'interface IDispatch pour obtenir un objet du Plugin de Maxthon, qui peut être utilisé de la même façon qu'un objet externe de Maxthon pour les Plugins script (cf. les commandes ci-dessous des Plugins script), pour interagir avec le Document Object Model des onglets et Maxthon.

Notez que Maxthon 2.0 est "multithread" (un "thread" pour chaque onglet). Les Plugins développés pour une interaction approfondie avec le Document Object Model des onglets doivent être développés en COM (par onglet) au lieu de COM_Global ainsi ils pourront fonctionner plus efficacement avec le même "thread" d'un onglet individuel.

==== '''2. Type - Button, SideBar, Toolbar, COM_Button, MHO, and MHO_Button''' ====

'''Button''' - Un bouton sera ajouté sur la barre des Plugins. L'opération spécifiée par le script (Plugin Script), l'exécutable (Plugin EXE), la DLL (Plugin COM) sera exécutée lorsque le bouton sera cliqué. Optionnellement, Les Plugins de bouton peuvent implémenter un menu déroulant pour le Plugin. Un Plugin de bouton COM doit implémenter l'interface IOleCommandTarget pour recevoir le clic du bouton. Si un menu est implémenté, la fonction IOleCommandTarget_Exec recevra un id de commande de 1 lorsque le bouton est cliqué, et un id de commande de 2 lorsque le premier menu est cliqué, etc. Un Plugin de bouton COM est crée lorsque le bouton est cliqué et est détruit lorsque l'onglet est fermé (comme IE7).

'''SideBar''' - Un bouton sera ajouté à la barre latérale, et un élément sera ajouté au menu principal > Affichage > Barre latérale. Lorsque le bouton ou l’élément du menu est cliqué, la barre latérale de Maxthon s'ouvrira et affichera le fichier HTML spécifié par le Plugin (Plugin script), ou la fenêtre spécifiée par le Plugin à travers l'interface IDeskBand (Plugin com ou com_global).

'''Toolbar''' - Les Plugins de barre d'outils doivent être écrits en COM. Une nouvelle barre d'outils sera ajoutée, qui pourra être affichée ou cachée à partir du menu principal > Affichage > Barre d'outils. Un Plugin de barre d'outils doit implémenter l'interface IDeskBand pour spécifier la fenêtre de la barre d'outils. Les Plugins de barre d'outils peuvent être COM ou COM_Global. Les Plugin de barre d'outils COM sont crées par onglet lorsque l'onglet est crée, et sont détruit lorsque l'onglet est fermé. Cela permet l'adoption de certaines barres d'outils d'IE dans Maxthon avec le minimum ou aucun changement. Les barres d'outils COM_Global sont crées seulement au démarrage de Maxthon, et sont détruit à la fermeture de Maxthon. Si une barre d'outils COM_Global implémente l'interface IObjectWithSite, elle peut obtenir le pointeur sur webbrowser de l'onglet actif à travers SetSite. Lorsque l'onglet actif est modifié, SetSite sera appelé de nouveau pour passer le pointeur sur webbrowser du nouvel onglet actif.

'''COM_Button''' - Les Plugins COM_Button sont identiques au Plugins de barre d'outils, à l'exception près que les Plugins COM_Button sont affichés dans Maxthon comme un bouton, et non pas comme une barre d'outils. Un Plugin COM_Button a la flexibilité de positionnement dans l'interface de Maxthon comme les autres boutons, mais il supporte également l'amélioration de l'interface d'une barre d'outils par rapport à un bouton.

'''MHO''' - Un Plugin MHO est identique au Browser Helper Object d'IE et doit être écrit en COM. Les Plugins MHO sont créés par onglet lorsque l'onglet est créé, et sont détruit lorsque l'onglet est fermé. Les Plugins MHO doivent implémenter l'interface IObjectWithSite pour obtenir un pointeur sur webbrowser de l'onglet pour interagir avec le DOM. Les Plugins MHO n'ont pas d'interface.

'''MHO_Button''' - Le Plugin MHO est une combinaison d'un Plugin MHO et d'un Plugin bouton COM. Les Plugins MHO_Button sont créés par onglet lorsque l'onglet est créé, et sont détruit lorsque l'onglet est fermé. En plus, une instance de Plugin MHO_Button sera créée lorsque son bouton est cliqué, et l'instance sera détruite lorsque l'opération est terminée. Le Plugin MHO_Button ajoute essentiellement une interface bouton au Plugin MHO.

== Créer un Plugin pour Maxthon ==

'''Composants majeurs d’un Plugin de Maxthon'''

Un Plugin de Maxthon contient généralement les fichiers suivants :

'''Fichiers INI''' – Le fichier plugin.ini est nécessaire pour tous les Plugins de Maxthon. Il définit plusieurs attributs du Plugin.

'''Fichiers HTML/DLL/EXE file''' – Le composant principal nécessaire à tous les Plugins de Maxthon spécifiant l'opération à réaliser ou le contenu à afficher.

'''Fichier Icônes''' – L'icône du bouton (*.ICO) nécessaire aux Plugins bouton et barre latérale. Le Plugin COM et EXE peut avoir besoin d'icônes dans ces propres ressources.

'''Config.html''' – Un fichier HTML optionnel pour être utilisé avec les Plugins de type Script et HTML comme boîte de dialogue de configuration.

'''Fichier plugin.ini'''

[General] nécessaire à la définition de plusieurs attributs du plugin

'''Name'''= nom du Plugin

'''Author'''= nom de l'auteur

'''Version'''= Version du Plugin

'''ModuleType'''= Peut être Script, HTML, EXE, COM, or COM_Global

'''FileName'''= Peut-être un fichier HTML (Plugins Script et HTML), un fichier DLL (Plugins COM) ou un fichier EXE (Plugins EXE)

'''Comments'''= La description affichée dans les options du Plugin et/ou l'info-bulle du Plugin de type Button

'''Type'''= Peut être M2Plugin_Button, M2Plugin_Sidebar, M2Plugin_Toolbar, M2Plugin_COM_Button, M2Plugin_MHO, ou M2Plugin_MHO_Button

'''IdealSize'''= La largeur et la hauteur de l'interface du Plugin (ex. 120 20, pour un Plugin HTML seulement)

'''IdealSizeVertical'''= La largeur et la hauteur de l'interface du Plugin lorsqu'il est ancré verticalement (ex 120 20, optionnel pour un Plugin HTML)

'''Icon'''= L'icône du bouton pour les Plugins de type Button ou Sidebar

'''HotIcon'''= L'icône du bouton lorsque le bouton du Plugin est survolé

'''CLSID'''= Le CSLID pour les Plugins de type COM et COM_Global

'''DefaultLocation'''= Optionnel, défini la localisation par défaut de l'icône du Plugin, peut être '''None''' (dans la barre des Plugins, mais non affichée après l'installation, l'utilisateur peut afficher le bouton à partir du menu Afficher ou masquer des boutons), '''MenuBar''', '''ToolBar''', ou '''StatusBar'''. S’il n'est pas défini, le Plugin sera affiché dans la barre des Plugins. Pour le Plugin de type '''Button''' et pour Maxthon 2.0.5 ou supérieur.

'''StartAfterPageDoneURL'''= Optionnel, définit les adresses où le Plugin doit démarrer automatiquement, supporte les caractères joker, et on peut utiliser "|" pour séparer les adresses, ex. '''*maxthon.com*|forum.maxthon.cn*'''. Si il n'est pas défini, le Plugin démarrera pour toutes les adresses, équivalent à '''*'''. Pour les Plugins de types '''Script''' et '''Button''' et pour Maxthon 2.0.5 ou supérieur.

'''StartAfterPageDoneURLExclude'''= Optionnel, défini où le Plugin ne doit pas démarrer automatiquement, a une priorité supérieure à startAfterPageDoneUrl. Utilise le même format que startAfterPageDoneUrl ex. '''forum.maxthon.cn/index.php?|*.maxthon.cn/index.php?showtopic*'''. Pour les Plugins de types '''Script''' et '''Button''' et pour Maxthon 2.0.5 ou supérieur.

[MyIE2Buttons] Optionnel pour définir le menu déroulant pour les Plugins de types Button et MHO_Button

'''Count'''= Le nombre d'éléments du menu déroulant

'''Name1'''= Le nom du 1er élément du menu déroulant

'''FileName1'''= Le nom du fichier, ou le nom du fichier + les paramètres pour les Plugins de type EXE, du 1er élément du menu déroulant. Pour les Plugins de type COM Button et COM MHO_Button, mettre un nom arbitraire et distinct, ex. 1 pour FileName1 et 2 pour FileName2 etc.

'''Installation d'un Plugin de Maxthon'''

Les Plugins de Maxthon sont installés dans le répertoire "Plugin" du dossier d'installation de Maxthon. Chaque Plugin possède son propre dossier dédié qui contient le fichier plugin.ini et les autres fichiers nécessaires et/ou sous-dossiers.

Un Plugin terminé, comprenant le dossier du Plugin et tous les fichiers et/ou sous-dossiers peut-être compressé dans un fichier ZIP (*.zip) pour être distribué.

'''Maxthon 2.0'''

Maxthon 2.0 supporte un pack d'installation M2P de plugins (essentiellement un *.zip renommé en *.m2p. Le Plugin sera installé lorsque le fichier M2P est double cliqué où glisser/déplacer dans la fenêtre de Maxthon.

'''Maxthon 1.X'''

Les Plugins sont installés dans Maxthon 1.x en suivant cette procédure :

1. Fermer Maxthon

2. Extraire le fichier zip du Plugin dans le dossier "Plugin" du répertoire d'installation de Maxthon. En général, le fichier plugin.ini devrait se trouver dans C:\Program Files\Maxthon\Plugin\NewPlugin\plugin.ini

3. Ouvrir Maxthon, la fenêtre d'installation du Plugin devrait s'afficher

4. Confirmer l'installation du nouveau plugin

== Commandes des Plugins Script de Maxthon ==

Maxthon propose plusieurs commandes pour améliorer la capacité des Plugins Script. Ces commandes peuvent être exécutées par l'intermédiaire de l'objet window.external. Certaines commandes nécessitent un ID de sécurité générée au démarrage de Maxthon.

'''Comment obtenir l'ID de sécurité'''

1. Les Plugins Script de type Button peuvent utiliser "%max_security_id" pour l'ID sécurité

2. Les Plugins Script de type Sidebar et les Plugins HTML de type Button doivent charger "max.src", un script généré par Maxthon. Ensuite "max_security_id" peut être utilisé :

<script src=max.src></script>

'''Référence des commandes des Plugins de Maxthon'''

Sauf indication contraire, les commandes suivantes sont applicables pour Maxthon 2.0 et Maxthon 1.X :

1. '''max_version''' - retourne le numéro de version de Maxthon

Exemple :
alert(external.max_version);

2. '''max_language_id''' - retourne l'ID de langue de Maxthon

Exemple :
alert(external.max_language_id);

Note : Maxthon 2.0 et Maxthon 1.X ont un format d'ID de langue différent

3. '''tab_count''' - retourne le nombre d'onglets ouvert dans Maxthon

Exemple :
alert(external.tab_count);

4. '''cur_sel''' - retourne l'index de l'onglet en cours de Maxthon

Exemple :
alert(external.cur_sel);

5. '''m2_plugin_folder( security_id , plugin_name )''' - retourne le chemin du dossier du Plugin spécifié

Exemple :
alert(external.m2_plugin_folder( %max_security_id , 'ViewSource!'));

6. '''m2_run_cmd( security_id , command_id )''' - exécute l'ID de la commande spécifiée

Exemple :
external. m2_run_cmd( %max_security_id , 32772 ));

Note: Maxthon 2.0 et Maxthon 1.X ont des ID de commande différents. Les ID des commandes se trouvent dans le fichier langue de Maxthon.

7. '''get_tab( security_id , tab_index )''' - retourne l'objet Windows de l'onglet spécifié

Exemple :
var oWin=external.get_tab(%max_security_id, 0);
alert(oWin.document.URL);

8. '''activate_tab( security_id , tab_index )''' - active l'onglet spécifié

Exemple :
external.activate_tab(%max_security_id, 0);

9. '''close_tab( security_id , tab_index )''' - ferme l'onglet spécifié

Exemple :
external.close_tab(%max_security_id, 0);

10. '''readFile( security_id, plugin_name, file_name)''' - lis le contenu du fichier texte spécifié

Example :
var sText=external.readFile(%max_security_id, 'ViewPage', 'readme.txt');
alert(sText);

11. '''writeFile( security_id, plugin_name, file_name, content )''' - écris le contenu dans le fichier texte spécifié

Exemple :
external.writeFile(%max_security_id, 'ViewPage', 'test.txt', 'Ceci est le contenu du fichier');

12. '''m2_readIni( security_id, plugin_name , file_name , section_name , key , default_value)''' - lis les données du fichier INI spécifié

Exemple :
var sDownloadTool=external.m2_readIni(%max_security_id, 'ViewPage', 'plugin.ini', 'Settings', 'Tool', '');
alert(sDownloadTool);

13. '''m2_writeIni( security_id , plugin_name , file_name , section_name , key , value )''' - écris les données dans le fichier INI spécifié

Exemple :
external.m2_writeIni(%max_security_id, 'ViewPage', 'test.ini', 'Config', 'height', '100px');

14. '''max_modelessDialog( security_id , url , option , attr , window )''' - retourne une page de dialogue Web modale

Exemple :
var oDialog= external.max_modelessDialog( %max_security_id , 'blank.html', window , '', window );
var oDoc=oDialog.document;
oDoc.write('Testing');
oDoc.close();

15. '''max_activex(security_id ,program_id)''' - retourne l'objet ActiveX spécifié

Exemple :
var oWSH=external.max_activex(%max_security_id, 'WScript.Shell');
oWSH.run('notepad.exe');

16. '''m2_search_text(security_id)''' - retourne le texte de la barre d'adresses

Exemple :
alert(m2_search_text(%max_security_id));

17. '''max_callback(event_name)''' - une fonction qui est exécutée lorsque certains événements de Maxthon se produisent (pour les Plugins HTML de type Button et les Plugins Script de type Sidebar)

Les Plugins HTML de type Button et les Plugins Script de type Sidebar peuvent utiliser la fonction max_callback pour réagir à certains événements de Maxthon comme le changement d'onglet.

Exemple :
function max_callback(x){
if(x=='tab_change') alert('L'onglet en cours à changé.');
}

En testant le paramètre de la fonction max_callback, le Plugin peut récupérer les événements suivants :

'''Plugins HTML de type Button'''

'''tab_change''' – après que l'onglet en cours soit changé

'''document_Complete''' - après que l'onglet en cours soit entièrement chargé

'''self_destroy''' - lorsque le HTML est déchargé, normalement lorsque Maxthon est fermé

'''Plugins Script de type Sidebar'''

'''sidebar_tab_change''' - après que l'onglet en cours soit changé

'''sidebar_activate''' - lorsque le Plugin Sidebar est activé

'''sidebar_deactivate''' - lorsque le Plugin Sidebar est désactivé

'''sidebar_unload''' - lorsque le Plugin Sidebar est déchargé (Maxthon est fermé)

18. '''max_getObj''' (pour Maxthon 2.0 seulement) - retourne plusieurs objets de Maxthon :

'''Info''' - information générale sur Maxthon

'''Adhunter''' – à propos du tueur de pubs

'''FavManager''' – à propos des Favoris

'''RssManager''' – à propos des flux RSS

'''PluginManager''' - à propos des Plugins, pour Maxthon 2.0.5 ou supérieur

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');

'''L'objet Info supporte les propriétés et méthodes suivantes :'''

Propriétés :

'''fileProxy''' - en lecture seule, retourne le chemin du document de configuration du Proxy utilisateur en cours.

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo.fileProxy);

'''folderUser''' - en lecture seule, retourne le chemin du dossier du profil de l'utilisateur en cours

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo. folderUser);

Méthodes :

'''getFolderPluginData(plugin_name)''' - obtiens le chemin du dossier de stockage des données d'un Plugin pour l'utilisateur en cours et le Plugin indiqué

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo.getFolderPluginData('ViewSource!'));

'''L'object AdHunter supporte les méthodes suivantes :'''

Méthodes :

'''reloadFilter(filter_name)''' – recharge le filtre de Maxthon spécifié (actuellement seulement les filtres de contenu) après avoir modifié le filtre en question

Exemple :
var oAdHunter=external.max_getObj(%max_security_id, 'AdHunter');
oAdHunter.reloadFilter('content');

'''enableFilter(filter_name, bEnable)''' – active ou désactive le filtre de 'contenu' ou de 'Popup' de Maxthon

Exemple :
var oAdHunter=external.max_getObj(%max_security_id, 'AdHunter');
oAdHunter.enableFilter ('content', false);

'''L'objet PluginManager supporte les méthodes suivantes :'''

'''getPluginFolder''' - retourne le chemin du dossier principal du Plugin de Maxthon

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getPluginFolder)

'''getCount''' - retourne le nombre de tous les Plugins installés, qu'ils soient activés ou désactivés

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getCount)

'''getList''' - retourne une liste qui contient des informations comme le nom, l'auteur, etc. de tous les Plugins

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getList)

'''getPlugin(Index)''' - Index est un nombre, retourne les objets du Plugin correspondant

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
var oPlugin=oPluginManager.getPlugin(0);

'''L'objet Plugin retourné de getPlugin(Index) supporte les propriétés et méthodes suivantes :'''

Propriétés :

'''title''' - lecture seule, retourne le nom du Plugin

Exemple :
alert(oPlugin.title);

'''folderName''' - lecture seule, retourne le nom du dossier du Plugin

Exemple :
alert(oPlugin.folderName);

'''fullPath''' - lecture seule, retourne le chemin complet du dossier du Plugin

Exemple :
alert(oPlugin.fullPath);

'''enable''' - lecture/écriture, retourne ou définit si le Plugin est actif

Exemple :
oPlugin.enable=false;
alert(oPlugin.enable);
oPlugin.enable=true;
alert(oPlugin.enable);

'''startAfterPageDone''' - lecture/écriture, retourne ou définit si le Plugin est en démarrage automatique

Exemple :
oPlugin.startAfterPageDone = true;
alert(oPlugin.startAfterPageDone);
oPlugin.startAfterPageDone = false;
alert(oPlugin.startAfterPageDone);

'''startAfterPageDoneUrl''' - lecture/écriture, retourne ou définit l'adresse où le Plugin sera démarré automatiquement

Exemple :
oPlugin.startAfterPageDoneUrl='*maxthon.com*|*maxthon.cn*';
alert(oPlugin.startAfterPageDoneUrl);

Mêthodes :

'''config()''' - ouvre la boîte de dialogue de configuration du Plugin (config.html)

Exemple :
oPlugin.config();

'''remove()''' - supprime le Plugin

Exemple :
oPlugin.remove();

== Mscript ==

Maxthon 2.0 supporte des mscripts personnalisés en plus des scripts pour les Plugins de type Button. Contrairement aux scripts normaux, les mscripts ne sont pas exécutés sur des pages Web et ainsi les mscripts ne sont pas sujets aux restrictions de sécurité imposées aux scripts normaux, et on ne doit pas craindre qu'ils soient exploités par des pages Web. Les mscripts peuvent grandement améliorer les fonctionnalités des Plugins depuis que les mscripts peuvent fonctionner avec les scripts désactivés et les mscripts peuvent accéder aux contenus des frames à travers les domaines. Pour utiliser mscript dans un Plugin de type Button, remplacez la balise <script...> par <mscript...>

Exemple - le Plugin de type Button peut désactiver les scripts dans la page en cours en modifiant le contrôle de contenu de Maxthon :

<script language="javascript">
external.m2_run_cmd(%max_security_id, 33175);
</script>

Mais après que les scripts soient désactivés, le Plugin ne peut plus fonctionner. Ainsi, il ne pourra plus réactiver les scripts dans la page en cours. D'autre part, le Plugin mscript suivant peut fonctionner avec les scripts désactivés, ainsi il pourra réactiver les scripts dans la page en cours.

<mscript language="javascript">
external.m2_run_cmd(0, 33175);
</script>

Notez qu'un nombre arbitraire peut être utilisé comme %max_security_id lorsque le mscript est utilisé.

<center>[[Base de connaissances de Maxthon 2.0]]</center>

Les scripts de Maxthon v2.0

2008-10-02T13:02:11Z

Ray1 : /* Commandes des Plugins Script de Maxthon */

== '''Types de Plugin de Maxthon''' ==

Le type de Plugin de Maxthon est défini par ModuleType (Script, HTML, COM et EXE) et Type (Button, Sidebar, Toolbar, COM_Button, MHO, MHO_Button) simultanément :

Button SideBar Toolbar COM_Button MHO MHO_Button
Script oui oui
HTML oui
EXE oui
COM oui oui oui oui oui oui
COM_Global oui oui oui oui

==== '''1. ModuleType - Script, HTML, EXE, COM et COM_Global''' ====

'''Script''' - Le Plugin Script peut être de type button, qui exécute un script lorsqu'il est cliqué. le script peut être dans un langage supporté par IE, comme le JavaScript ou le vbscript. Maxthon 2.0 supporte le mscript qui exécute l'environnement (plus de détails ci-après). Le Script peut également être de type sidebar, qui affiche un fichier HTML dans la barre latérale.

'''HTML''' - Un nouveau type de Plugin pour Maxthon 2.0 seulement. Le Plugin de type HTML est similaire au Plugin Script Sidebar dans sa nature. La différence majeure est que le Plugin Script Sidebar est affiché dans la barre latérale de Maxthon alors que le Plugin HTML est affiché comme un bouton dans la barre des Plugins ou n'importe quelle barre d'outils (barre d'état, barre des menus, barre des onglets, barre d'adresses...).

'''EXE''' - Le Plugin EXE sera affiché comme un bouton sur la barre des Plugins. Le Plugin EXE peut être n'importe quel fichier exécutable. Maxthon peut passer plusieurs paramètres au fichier exécutable comme l'URL de la page Web en cours ou le "handle" de la fenêtre de Maxthon.

'''COM''' - Le Plugin COM peut-être écrit en n'importe quel langage de programmation supporté par MSCOM, comme C++, Delphi, Visual Basic, C# etc. Les Plugins COM sont créés par onglet lors de la création d'un onglet (Types SideBar/Toolbar/MHO/COM_Button) ou lorsque le bouton du Plugin est cliqué (Type Button), et est détruit lorsque l'onglet est fermé. Un Plugin COM peut implémenter l'interface IObjectWithSite pour obtenir le pointeur "webbrowser" de l'onglet, l'événement du navigateur et le Document Object Model pour le manipuler.

'''COM_Global''' - Les Plugins COM_Global sont créés seulement une fois au démarrage de Maxthon, et sont détruits à la fermeture de Maxthon. Les Plugins COM_Global sont souvent pour les fonctions de navigation qui ne sont pas en relation avec le Document Object Model. Ainsi, les Plugins COM_Global peuvent implémenter une fonction PutMaxCommander à travers l'interface IDispatch pour obtenir un objet du Plugin de Maxthon, qui peut être utilisé de la même façon qu'un objet externe de Maxthon pour les Plugins script (cf. les commandes ci-dessous des Plugins script), pour interagir avec le Document Object Model des onglets et Maxthon.

Notez que Maxthon 2.0 est "multithread" (un "thread" pour chaque onglet). Les Plugins développés pour une interaction approfondie avec le Document Object Model des onglets doivent être développés en COM (par onglet) au lieu de COM_Global ainsi ils pourront fonctionner plus efficacement avec le même "thread" d'un onglet individuel.

==== '''2. Type - Button, SideBar, Toolbar, COM_Button, MHO, and MHO_Button''' ====

'''Button''' - Un bouton sera ajouté sur la barre des Plugins. L'opération spécifiée par le script (Plugin Script), l'exécutable (Plugin EXE), la DLL (Plugin COM) sera exécutée lorsque le bouton sera cliqué. Optionnellement, Les Plugins de bouton peuvent implémenter un menu déroulant pour le Plugin. Un Plugin de bouton COM doit implémenter l'interface IOleCommandTarget pour recevoir le clic du bouton. Si un menu est implémenté, la fonction IOleCommandTarget_Exec recevra un id de commande de 1 lorsque le bouton est cliqué, et un id de commande de 2 lorsque le premier menu est cliqué, etc. Un Plugin de bouton COM est crée lorsque le bouton est cliqué et est détruit lorsque l'onglet est fermé (comme IE7).

'''SideBar''' - Un bouton sera ajouté à la barre latérale, et un élément sera ajouté au menu principal > Affichage > Barre latérale. Lorsque le bouton ou l’élément du menu est cliqué, la barre latérale de Maxthon s'ouvrira et affichera le fichier HTML spécifié par le Plugin (Plugin script), ou la fenêtre spécifiée par le Plugin à travers l'interface IDeskBand (Plugin com ou com_global).

'''Toolbar''' - Les Plugins de barre d'outils doivent être écrits en COM. Une nouvelle barre d'outils sera ajoutée, qui pourra être affichée ou cachée à partir du menu principal > Affichage > Barre d'outils. Un Plugin de barre d'outils doit implémenter l'interface IDeskBand pour spécifier la fenêtre de la barre d'outils. Les Plugins de barre d'outils peuvent être COM ou COM_Global. Les Plugin de barre d'outils COM sont crées par onglet lorsque l'onglet est crée, et sont détruit lorsque l'onglet est fermé. Cela permet l'adoption de certaines barres d'outils d'IE dans Maxthon avec le minimum ou aucun changement. Les barres d'outils COM_Global sont crées seulement au démarrage de Maxthon, et sont détruit à la fermeture de Maxthon. Si une barre d'outils COM_Global implémente l'interface IObjectWithSite, elle peut obtenir le pointeur sur webbrowser de l'onglet actif à travers SetSite. Lorsque l'onglet actif est modifié, SetSite sera appelé de nouveau pour passer le pointeur sur webbrowser du nouvel onglet actif.

'''COM_Button''' - Les Plugins COM_Button sont identiques au Plugins de barre d'outils, à l'exception près que les Plugins COM_Button sont affichés dans Maxthon comme un bouton, et non pas comme une barre d'outils. Un Plugin COM_Button a la flexibilité de positionnement dans l'interface de Maxthon comme les autres boutons, mais il supporte également l'amélioration de l'interface d'une barre d'outils par rapport à un bouton.

'''MHO''' - Un Plugin MHO est identique au Browser Helper Object d'IE et doit être écrit en COM. Les Plugins MHO sont créés par onglet lorsque l'onglet est créé, et sont détruit lorsque l'onglet est fermé. Les Plugins MHO doivent implémenter l'interface IObjectWithSite pour obtenir un pointeur sur webbrowser de l'onglet pour interagir avec le DOM. Les Plugins MHO n'ont pas d'interface.

'''MHO_Button''' - Le Plugin MHO est une combinaison d'un Plugin MHO et d'un Plugin bouton COM. Les Plugins MHO_Button sont créés par onglet lorsque l'onglet est créé, et sont détruit lorsque l'onglet est fermé. En plus, une instance de Plugin MHO_Button sera créée lorsque son bouton est cliqué, et l'instance sera détruite lorsque l'opération est terminée. Le Plugin MHO_Button ajoute essentiellement une interface bouton au Plugin MHO.

== Créer un Plugin pour Maxthon ==

'''Composants majeurs d’un Plugin de Maxthon'''

Un Plugin de Maxthon contient généralement les fichiers suivants :

'''Fichiers INI''' – Le fichier plugin.ini est nécessaire pour tous les Plugins de Maxthon. Il définit plusieurs attributs du Plugin.

'''Fichiers HTML/DLL/EXE file''' – Le composant principal nécessaire à tous les Plugins de Maxthon spécifiant l'opération à réaliser ou le contenu à afficher.

'''Fichier Icônes''' – L'icône du bouton (*.ICO) nécessaire aux Plugins bouton et barre latérale. Le Plugin COM et EXE peut avoir besoin d'icônes dans ces propres ressources.

'''Config.html''' – Un fichier HTML optionnel pour être utilisé avec les Plugins de type Script et HTML comme boîte de dialogue de configuration.

'''Fichier plugin.ini'''

[General] nécessaire à la définition de plusieurs attributs du plugin

'''Name'''= nom du Plugin

'''Author'''= nom de l'auteur

'''Version'''= Version du Plugin

'''ModuleType'''= Peut être Script, HTML, EXE, COM, or COM_Global

'''FileName'''= Peut-être un fichier HTML (Plugins Script et HTML), un fichier DLL (Plugins COM) ou un fichier EXE (Plugins EXE)

'''Comments'''= La description affichée dans les options du Plugin et/ou l'info-bulle du Plugin de type Button

'''Type'''= Peut être M2Plugin_Button, M2Plugin_Sidebar, M2Plugin_Toolbar, M2Plugin_COM_Button, M2Plugin_MHO, ou M2Plugin_MHO_Button

'''IdealSize'''= La largeur et la hauteur de l'interface du Plugin (ex. 120 20, pour un Plugin HTML seulement)

'''IdealSizeVertical'''= La largeur et la hauteur de l'interface du Plugin lorsqu'il est ancré verticalement (ex 120 20, optionnel pour un Plugin HTML)

'''Icon'''= L'icône du bouton pour les Plugins de type Button ou Sidebar

'''HotIcon'''= L'icône du bouton lorsque le bouton du Plugin est survolé

'''CLSID'''= Le CSLID pour les Plugins de type COM et COM_Global

'''DefaultLocation'''= Optionnel, défini la localisation par défaut de l'icône du Plugin, peut être '''None''' (dans la barre des Plugins, mais non affichée après l'installation, l'utilisateur peut afficher le bouton à partir du menu Afficher ou masquer des boutons), '''MenuBar''', '''ToolBar''', ou '''StatusBar'''. S’il n'est pas défini, le Plugin sera affiché dans la barre des Plugins. Pour le Plugin de type '''Button''' et pour Maxthon 2.0.5 ou supérieur.

'''StartAfterPageDoneURL'''= Optionnel, définit les adresses où le Plugin doit démarrer automatiquement, supporte les caractères joker, et on peut utiliser "|" pour séparer les adresses, ex. '''*maxthon.com*|forum.maxthon.cn*'''. Si il n'est pas défini, le Plugin démarrera pour toutes les adresses, équivalent à '''*'''. Pour les Plugins de types '''Script''' et '''Button''' et pour Maxthon 2.0.5 ou supérieur.

'''StartAfterPageDoneURLExclude'''= Optionnel, défini où le Plugin ne doit pas démarrer automatiquement, a une priorité supérieure à startAfterPageDoneUrl. Utilise le même format que startAfterPageDoneUrl ex. '''forum.maxthon.cn/index.php?|*.maxthon.cn/index.php?showtopic*'''. Pour les Plugins de types '''Script''' et '''Button''' et pour Maxthon 2.0.5 ou supérieur.

[MyIE2Buttons] Optionnel pour définir le menu déroulant pour les Plugins de types Button et MHO_Button

'''Count'''= Le nombre d'éléments du menu déroulant

'''Name1'''= Le nom du 1er élément du menu déroulant

'''FileName1'''= Le nom du fichier, ou le nom du fichier + les paramètres pour les Plugins de type EXE, du 1er élément du menu déroulant. Pour les Plugins de type COM Button et COM MHO_Button, mettre un nom arbitraire et distinct, ex. 1 pour FileName1 et 2 pour FileName2 etc.

'''Installation d'un Plugin de Maxthon'''

Les Plugins de Maxthon sont installés dans le répertoire "Plugin" du dossier d'installation de Maxthon. Chaque Plugin possède son propre dossier dédié qui contient le fichier plugin.ini et les autres fichiers nécessaires et/ou sous-dossiers.

Un Plugin terminé, comprenant le dossier du Plugin et tous les fichiers et/ou sous-dossiers peut-être compressé dans un fichier ZIP (*.zip) pour être distribué.

'''Maxthon 2.0'''

Maxthon 2.0 supporte un pack d'installation M2P de plugins (essentiellement un *.zip renommé en *.m2p. Le Plugin sera installé lorsque le fichier M2P est double cliqué où glisser/déplacer dans la fenêtre de Maxthon.

'''Maxthon 1.X'''

Les Plugins sont installés dans Maxthon 1.x en suivant cette procédure :

1. Fermer Maxthon

2. Extraire le fichier zip du Plugin dans le dossier "Plugin" du répertoire d'installation de Maxthon. En général, le fichier plugin.ini devrait se trouver dans C:\Program Files\Maxthon\Plugin\NewPlugin\plugin.ini

3. Ouvrir Maxthon, la fenêtre d'installation du Plugin devrait s'afficher

4. Confirmer l'installation du nouveau plugin

== Commandes des Plugins Script de Maxthon ==

Maxthon propose plusieurs commandes pour améliorer la capacité des Plugins Script. Ces commandes peuvent être exécutées par l'intermédiaire de l'objet window.external. Certaines commandes nécessitent un ID de sécurité générée au démarrage de Maxthon.

'''Comment obtenir l'ID de sécurité'''

1. Les Plugins Script de type Button peuvent utiliser "%max_security_id" pour l'ID sécurité

2. Les Plugins Script de type Sidebar et les Plugins HTML de type Button doivent charger "max.src", un script généré par Maxthon. Ensuite "max_security_id" peut être utilisé :

<script src=max.src></script>

'''Référence des commandes des Plugins de Maxthon'''

Sauf indication contraire, les commandes suivantes sont applicables pour Maxthon 2.0 et Maxthon 1.X :

1. '''max_version''' - retourne le numéro de version de Maxthon

Exemple :
alert(external.max_version);

2. '''max_language_id''' - retourne l'ID de langue de Maxthon

Exemple :
alert(external.max_language_id);

Note : Maxthon 2.0 et Maxthon 1.X ont un format d'ID de langue différent

3. '''tab_count''' - retourne le nombre d'onglets ouvert dans Maxthon

Exemple :
alert(external.tab_count);

4. '''cur_sel''' - retourne l'index de l'onglet en cours de Maxthon

Exemple :
alert(external.cur_sel);

5. '''m2_plugin_folder( security_id , plugin_name )''' - retourne le chemin du dossier du Plugin spécifié

Exemple :
alert(external.m2_plugin_folder( %max_security_id , 'ViewSource!'));

6. '''m2_run_cmd( security_id , command_id )''' - exécute l'ID de la commande spécifiée

Exemple :
external. m2_run_cmd( %max_security_id , 32772 ));

Note: Maxthon 2.0 et Maxthon 1.X ont des ID de commande différents. Les ID des commandes se trouvent dans le fichier langue de Maxthon.

7. '''get_tab( security_id , tab_index )''' - retourne l'objet Windows de l'onglet spécifié

Exemple :
var oWin=external.get_tab(%max_security_id, 0);
alert(oWin.document.URL);

8. '''activate_tab( security_id , tab_index )''' - active l'onglet spécifié

Exemple :
external.activate_tab(%max_security_id, 0);

9. '''close_tab( security_id , tab_index )''' - ferme l'onglet spécifié

Exemple :
external.close_tab(%max_security_id, 0);

10. '''readFile( security_id, plugin_name, file_name)''' - lis le contenu du fichier texte spécifié

Example :
var sText=external.readFile(%max_security_id, 'ViewPage', 'readme.txt');
alert(sText);

11. '''writeFile( security_id, plugin_name, file_name, content )''' - écris le contenu dans le fichier texte spécifié

Exemple :
external.writeFile(%max_security_id, 'ViewPage', 'test.txt', 'Ceci est le contenu du fichier');

12. '''m2_readIni( security_id, plugin_name , file_name , section_name , key , default_value)''' - lis les données du fichier INI spécifié

Exemple :
var sDownloadTool=external.m2_readIni(%max_security_id, 'ViewPage', 'plugin.ini', 'Settings', 'Tool', '');
alert(sDownloadTool);

13. '''m2_writeIni( security_id , plugin_name , file_name , section_name , key , value )''' - écris les données dans le fichier INI spécifié

Exemple :
external.m2_writeIni(%max_security_id, 'ViewPage', 'test.ini', 'Config', 'height', '100px');

14. '''max_modelessDialog( security_id , url , option , attr , window )''' - retourne une page de dialogue Web modale

Exemple :
var oDialog= external.max_modelessDialog( %max_security_id , 'blank.html', window , '', window );
var oDoc=oDialog.document;
oDoc.write('Testing');
oDoc.close();

15. '''max_activex(security_id ,program_id)''' - retourne l'objet ActiveX spécifié

Exemple :
var oWSH=external.max_activex(%max_security_id, 'WScript.Shell');
oWSH.run('notepad.exe');

16. '''m2_search_text(security_id)''' - retourne le texte de la barre d'adresses

Exemple :
alert(m2_search_text(%max_security_id));

17. '''max_callback(event_name)''' - une fonction qui est exécutée lorsque certains événements de Maxthon se produisent (pour les Plugins HTML de type Button et les Plugins Script de type Sidebar)

Les Plugins HTML de type Button et les Plugins Script de type Sidebar peuvent utiliser la fonction max_callback pour réagir à certains événements de Maxthon comme le changement d'onglet.

Exemple :
function max_callback(x){
if(x=='tab_change') alert('L'onglet en cours à changé.');
}

En testant le paramètre de la fonction max_callback, le Plugin peut récupérer les événements suivants :

'''Plugins HTML de type Button'''

'''tab_change''' – après que l'onglet en cours soit changé

'''document_Complete''' - après que l'onglet en cours soit entièrement chargé

'''self_destroy''' - lorsque le HTML est déchargé, normalement lorsque Maxthon est fermé

'''Plugins Script de type Sidebar'''

'''sidebar_tab_change''' - après que l'onglet en cours soit changé

'''sidebar_activate''' - lorsque le Plugin Sidebar est activé

'''sidebar_deactivate''' - lorsque le Plugin Sidebar est désactivé

'''sidebar_unload''' - lorsque le Plugin Sidebar est déchargé (Maxthon est fermé)

18. '''max_getObj''' (pour Maxthon 2.0 seulement) - retourne plusieurs objets de Maxthon :

'''Info''' - information générale sur Maxthon

'''Adhunter''' – à propos du tueur de pubs

'''FavManager''' – à propos des Favoris

'''RssManager''' – à propos des flux RSS

'''PluginManager''' - à propos des Plugins, pour Maxthon 2.0.5 ou supérieur

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');

'''L'objet Info supporte les propriétés et méthodes suivantes :'''

Propriétés :

'''fileProxy''' - en lecture seule, retourne le chemin du document de configuration du Proxy utilisateur en cours.

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo.fileProxy);

'''folderUser''' - en lecture seule, retourne le chemin du dossier du profil de l'utilisateur en cours

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo. folderUser);

Méthodes :

'''getFolderPluginData(plugin_name)''' - obtiens le chemin du dossier de stockage des données d'un Plugin pour l'utilisateur en cours et le Plugin indiqué

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo.getFolderPluginData('ViewSource!'));

'''L'object AdHunter supporte les méthodes suivantes :'''

Méthodes :

'''reloadFilter(filter_name)''' – recharge le filtre de Maxthon spécifié (actuellement seulement les filtres de contenu) après avoir modifié le filtre en question

Exemple :
var oAdHunter=external.max_getObj(%max_security_id, 'AdHunter');
oAdHunter.reloadFilter('content');

'''enableFilter(filter_name, bEnable)''' – active ou désactive le filtre de 'contenu' ou de 'Popup' de Maxthon

Exemple :
var oAdHunter=external.max_getObj(%max_security_id, 'AdHunter');
oAdHunter.enableFilter ('content', false);

'''L'objet PluginManager supporte les méthodes suivantes :'''

'''getPluginFolder''' - retourne le chemin du dossier principal du Plugin de Maxthon

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getPluginFolder)

'''getCount''' - retourne le nombre de tous les Plugins installés, qu'ils soient activés ou désactivés

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getCount)

'''getList''' - retourne une liste qui contient des informations comme le nom, l'auteur, etc. de tous les Plugins

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getList)

'''getPlugin(Index)''' - Index est un nombre, retourne les objets du Plugin correspondant

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
var oPlugin=oPluginManager.getPlugin(0);

'''L'objet Plugin retourné de getPlugin(Index) supporte les propriétés et méthodes suivantes :'''

Propriétés :

'''title''' - lecture seule, retourne le nom du Plugin

Exemple :
alert(oPlugin.title);

'''folderName''' - lecture seule, retourne le nom du dossier du Plugin

Exemple :
alert(oPlugin.folderName);

'''fullPath''' - lecture seule, retourne le chemin complet du dossier du Plugin

Exemple :
alert(oPlugin.fullPath);

'''enable''' - lecture/écriture, retourne ou définit si le Plugin est actif

Exemple :
oPlugin.enable=false;
alert(oPlugin.enable);
oPlugin.enable=true;
alert(oPlugin.enable);

'''startAfterPageDone''' - lecture/écriture, retourne ou définit si le Plugin est en démarrage automatique

Exemple :
oPlugin.startAfterPageDone = true;
alert(oPlugin.startAfterPageDone);
oPlugin.startAfterPageDone = false;
alert(oPlugin.startAfterPageDone);

'''startAfterPageDoneUrl''' - lecture/écriture, retourne ou définit l'adresse où le Plugin sera démarré automatiquement

Exemple :
oPlugin.startAfterPageDoneUrl='*maxthon.com*|*maxthon.cn*';
alert(oPlugin.startAfterPageDoneUrl);

Mêthodes :

'''config()''' - ouvre la boîte de dialogue de configuration du Plugin (config.html)

Exemple :
oPlugin.config();

'''remove()''' - supprime le Plugin

Exemple :
oPlugin.remove();

== Mscript ==

Maxthon 2.0 supporte des mscript personnalisés en plus des scripts pour les Plugins de type Button. Contrairement au script normaux, les mscript ne sont pas exécutés sur des pages Web et aisni les mscript ne sont pas sujet aux restrictions de sécurité imposées au scripts normaux, et on ne doit pas craindre qu'ils soient exploités par des pages Web. Les mscript peuvent grandement améliorer les fonctionnalités des Plugins depuis que les mscript peuvent fonctionner avec les scripts désactivés et les mscript peuvent accéder aux contenus des frames à travers les domaines. Pour utiliser mscript dans un Plugin de type Button, remplacez la balise <script...> par <mscript...>

Exemple - le Plugin de type Button peut désactiver les script dans la page en cours en modifiant le contrôle de contenu de Maxthon :

<script language="javascript">
external.m2_run_cmd(%max_security_id, 33175);
</script>

Mais après que les scripts soient désactivés, le Plugin ne peut plus fonctionner. Ainsi il ne pourra plus réactiver les scripts dans la pages en cours. D'autre part, le Plugin mscript suivant peut fonctionner avec les scripts désactivés, ainsi il pourra réactiver les scripts dans la page en cours.

<mscript language="javascript">
external.m2_run_cmd(0, 33175);
</script>

Notez qu'un nombre arbitraire peut être utilisé comme %max_security_id lorsque le mscript est utilisé.

<center>[[Base de connaissances de Maxthon 2.0]]</center>

Les scripts de Maxthon v2.0

2008-10-02T12:54:58Z

Ray1 : /* Créer un Plugin pour Maxthon */

== '''Types de Plugin de Maxthon''' ==

Le type de Plugin de Maxthon est défini par ModuleType (Script, HTML, COM et EXE) et Type (Button, Sidebar, Toolbar, COM_Button, MHO, MHO_Button) simultanément :

Button SideBar Toolbar COM_Button MHO MHO_Button
Script oui oui
HTML oui
EXE oui
COM oui oui oui oui oui oui
COM_Global oui oui oui oui

==== '''1. ModuleType - Script, HTML, EXE, COM et COM_Global''' ====

'''Script''' - Le Plugin Script peut être de type button, qui exécute un script lorsqu'il est cliqué. le script peut être dans un langage supporté par IE, comme le JavaScript ou le vbscript. Maxthon 2.0 supporte le mscript qui exécute l'environnement (plus de détails ci-après). Le Script peut également être de type sidebar, qui affiche un fichier HTML dans la barre latérale.

'''HTML''' - Un nouveau type de Plugin pour Maxthon 2.0 seulement. Le Plugin de type HTML est similaire au Plugin Script Sidebar dans sa nature. La différence majeure est que le Plugin Script Sidebar est affiché dans la barre latérale de Maxthon alors que le Plugin HTML est affiché comme un bouton dans la barre des Plugins ou n'importe quelle barre d'outils (barre d'état, barre des menus, barre des onglets, barre d'adresses...).

'''EXE''' - Le Plugin EXE sera affiché comme un bouton sur la barre des Plugins. Le Plugin EXE peut être n'importe quel fichier exécutable. Maxthon peut passer plusieurs paramètres au fichier exécutable comme l'URL de la page Web en cours ou le "handle" de la fenêtre de Maxthon.

'''COM''' - Le Plugin COM peut-être écrit en n'importe quel langage de programmation supporté par MSCOM, comme C++, Delphi, Visual Basic, C# etc. Les Plugins COM sont créés par onglet lors de la création d'un onglet (Types SideBar/Toolbar/MHO/COM_Button) ou lorsque le bouton du Plugin est cliqué (Type Button), et est détruit lorsque l'onglet est fermé. Un Plugin COM peut implémenter l'interface IObjectWithSite pour obtenir le pointeur "webbrowser" de l'onglet, l'événement du navigateur et le Document Object Model pour le manipuler.

'''COM_Global''' - Les Plugins COM_Global sont créés seulement une fois au démarrage de Maxthon, et sont détruits à la fermeture de Maxthon. Les Plugins COM_Global sont souvent pour les fonctions de navigation qui ne sont pas en relation avec le Document Object Model. Ainsi, les Plugins COM_Global peuvent implémenter une fonction PutMaxCommander à travers l'interface IDispatch pour obtenir un objet du Plugin de Maxthon, qui peut être utilisé de la même façon qu'un objet externe de Maxthon pour les Plugins script (cf. les commandes ci-dessous des Plugins script), pour interagir avec le Document Object Model des onglets et Maxthon.

Notez que Maxthon 2.0 est "multithread" (un "thread" pour chaque onglet). Les Plugins développés pour une interaction approfondie avec le Document Object Model des onglets doivent être développés en COM (par onglet) au lieu de COM_Global ainsi ils pourront fonctionner plus efficacement avec le même "thread" d'un onglet individuel.

==== '''2. Type - Button, SideBar, Toolbar, COM_Button, MHO, and MHO_Button''' ====

'''Button''' - Un bouton sera ajouté sur la barre des Plugins. L'opération spécifiée par le script (Plugin Script), l'exécutable (Plugin EXE), la DLL (Plugin COM) sera exécutée lorsque le bouton sera cliqué. Optionnellement, Les Plugins de bouton peuvent implémenter un menu déroulant pour le Plugin. Un Plugin de bouton COM doit implémenter l'interface IOleCommandTarget pour recevoir le clic du bouton. Si un menu est implémenté, la fonction IOleCommandTarget_Exec recevra un id de commande de 1 lorsque le bouton est cliqué, et un id de commande de 2 lorsque le premier menu est cliqué, etc. Un Plugin de bouton COM est crée lorsque le bouton est cliqué et est détruit lorsque l'onglet est fermé (comme IE7).

'''SideBar''' - Un bouton sera ajouté à la barre latérale, et un élément sera ajouté au menu principal > Affichage > Barre latérale. Lorsque le bouton ou l’élément du menu est cliqué, la barre latérale de Maxthon s'ouvrira et affichera le fichier HTML spécifié par le Plugin (Plugin script), ou la fenêtre spécifiée par le Plugin à travers l'interface IDeskBand (Plugin com ou com_global).

'''Toolbar''' - Les Plugins de barre d'outils doivent être écrits en COM. Une nouvelle barre d'outils sera ajoutée, qui pourra être affichée ou cachée à partir du menu principal > Affichage > Barre d'outils. Un Plugin de barre d'outils doit implémenter l'interface IDeskBand pour spécifier la fenêtre de la barre d'outils. Les Plugins de barre d'outils peuvent être COM ou COM_Global. Les Plugin de barre d'outils COM sont crées par onglet lorsque l'onglet est crée, et sont détruit lorsque l'onglet est fermé. Cela permet l'adoption de certaines barres d'outils d'IE dans Maxthon avec le minimum ou aucun changement. Les barres d'outils COM_Global sont crées seulement au démarrage de Maxthon, et sont détruit à la fermeture de Maxthon. Si une barre d'outils COM_Global implémente l'interface IObjectWithSite, elle peut obtenir le pointeur sur webbrowser de l'onglet actif à travers SetSite. Lorsque l'onglet actif est modifié, SetSite sera appelé de nouveau pour passer le pointeur sur webbrowser du nouvel onglet actif.

'''COM_Button''' - Les Plugins COM_Button sont identiques au Plugins de barre d'outils, à l'exception près que les Plugins COM_Button sont affichés dans Maxthon comme un bouton, et non pas comme une barre d'outils. Un Plugin COM_Button a la flexibilité de positionnement dans l'interface de Maxthon comme les autres boutons, mais il supporte également l'amélioration de l'interface d'une barre d'outils par rapport à un bouton.

'''MHO''' - Un Plugin MHO est identique au Browser Helper Object d'IE et doit être écrit en COM. Les Plugins MHO sont créés par onglet lorsque l'onglet est créé, et sont détruit lorsque l'onglet est fermé. Les Plugins MHO doivent implémenter l'interface IObjectWithSite pour obtenir un pointeur sur webbrowser de l'onglet pour interagir avec le DOM. Les Plugins MHO n'ont pas d'interface.

'''MHO_Button''' - Le Plugin MHO est une combinaison d'un Plugin MHO et d'un Plugin bouton COM. Les Plugins MHO_Button sont créés par onglet lorsque l'onglet est créé, et sont détruit lorsque l'onglet est fermé. En plus, une instance de Plugin MHO_Button sera créée lorsque son bouton est cliqué, et l'instance sera détruite lorsque l'opération est terminée. Le Plugin MHO_Button ajoute essentiellement une interface bouton au Plugin MHO.

== Créer un Plugin pour Maxthon ==

'''Composants majeurs d’un Plugin de Maxthon'''

Un Plugin de Maxthon contient généralement les fichiers suivants :

'''Fichiers INI''' – Le fichier plugin.ini est nécessaire pour tous les Plugins de Maxthon. Il définit plusieurs attributs du Plugin.

'''Fichiers HTML/DLL/EXE file''' – Le composant principal nécessaire à tous les Plugins de Maxthon spécifiant l'opération à réaliser ou le contenu à afficher.

'''Fichier Icônes''' – L'icône du bouton (*.ICO) nécessaire aux Plugins bouton et barre latérale. Le Plugin COM et EXE peut avoir besoin d'icônes dans ces propres ressources.

'''Config.html''' – Un fichier HTML optionnel pour être utilisé avec les Plugins de type Script et HTML comme boîte de dialogue de configuration.

'''Fichier plugin.ini'''

[General] nécessaire à la définition de plusieurs attributs du plugin

'''Name'''= nom du Plugin

'''Author'''= nom de l'auteur

'''Version'''= Version du Plugin

'''ModuleType'''= Peut être Script, HTML, EXE, COM, or COM_Global

'''FileName'''= Peut-être un fichier HTML (Plugins Script et HTML), un fichier DLL (Plugins COM) ou un fichier EXE (Plugins EXE)

'''Comments'''= La description affichée dans les options du Plugin et/ou l'info-bulle du Plugin de type Button

'''Type'''= Peut être M2Plugin_Button, M2Plugin_Sidebar, M2Plugin_Toolbar, M2Plugin_COM_Button, M2Plugin_MHO, ou M2Plugin_MHO_Button

'''IdealSize'''= La largeur et la hauteur de l'interface du Plugin (ex. 120 20, pour un Plugin HTML seulement)

'''IdealSizeVertical'''= La largeur et la hauteur de l'interface du Plugin lorsqu'il est ancré verticalement (ex 120 20, optionnel pour un Plugin HTML)

'''Icon'''= L'icône du bouton pour les Plugins de type Button ou Sidebar

'''HotIcon'''= L'icône du bouton lorsque le bouton du Plugin est survolé

'''CLSID'''= Le CSLID pour les Plugins de type COM et COM_Global

'''DefaultLocation'''= Optionnel, défini la localisation par défaut de l'icône du Plugin, peut être '''None''' (dans la barre des Plugins, mais non affichée après l'installation, l'utilisateur peut afficher le bouton à partir du menu Afficher ou masquer des boutons), '''MenuBar''', '''ToolBar''', ou '''StatusBar'''. S’il n'est pas défini, le Plugin sera affiché dans la barre des Plugins. Pour le Plugin de type '''Button''' et pour Maxthon 2.0.5 ou supérieur.

'''StartAfterPageDoneURL'''= Optionnel, définit les adresses où le Plugin doit démarrer automatiquement, supporte les caractères joker, et on peut utiliser "|" pour séparer les adresses, ex. '''*maxthon.com*|forum.maxthon.cn*'''. Si il n'est pas défini, le Plugin démarrera pour toutes les adresses, équivalent à '''*'''. Pour les Plugins de types '''Script''' et '''Button''' et pour Maxthon 2.0.5 ou supérieur.

'''StartAfterPageDoneURLExclude'''= Optionnel, défini où le Plugin ne doit pas démarrer automatiquement, a une priorité supérieure à startAfterPageDoneUrl. Utilise le même format que startAfterPageDoneUrl ex. '''forum.maxthon.cn/index.php?|*.maxthon.cn/index.php?showtopic*'''. Pour les Plugins de types '''Script''' et '''Button''' et pour Maxthon 2.0.5 ou supérieur.

[MyIE2Buttons] Optionnel pour définir le menu déroulant pour les Plugins de types Button et MHO_Button

'''Count'''= Le nombre d'éléments du menu déroulant

'''Name1'''= Le nom du 1er élément du menu déroulant

'''FileName1'''= Le nom du fichier, ou le nom du fichier + les paramètres pour les Plugins de type EXE, du 1er élément du menu déroulant. Pour les Plugins de type COM Button et COM MHO_Button, mettre un nom arbitraire et distinct, ex. 1 pour FileName1 et 2 pour FileName2 etc.

'''Installation d'un Plugin de Maxthon'''

Les Plugins de Maxthon sont installés dans le répertoire "Plugin" du dossier d'installation de Maxthon. Chaque Plugin possède son propre dossier dédié qui contient le fichier plugin.ini et les autres fichiers nécessaires et/ou sous-dossiers.

Un Plugin terminé, comprenant le dossier du Plugin et tous les fichiers et/ou sous-dossiers peut-être compressé dans un fichier ZIP (*.zip) pour être distribué.

'''Maxthon 2.0'''

Maxthon 2.0 supporte un pack d'installation M2P de plugins (essentiellement un *.zip renommé en *.m2p. Le Plugin sera installé lorsque le fichier M2P est double cliqué où glisser/déplacer dans la fenêtre de Maxthon.

'''Maxthon 1.X'''

Les Plugins sont installés dans Maxthon 1.x en suivant cette procédure :

1. Fermer Maxthon

2. Extraire le fichier zip du Plugin dans le dossier "Plugin" du répertoire d'installation de Maxthon. En général, le fichier plugin.ini devrait se trouver dans C:\Program Files\Maxthon\Plugin\NewPlugin\plugin.ini

3. Ouvrir Maxthon, la fenêtre d'installation du Plugin devrait s'afficher

4. Confirmer l'installation du nouveau plugin

== Commandes des Plugins Script de Maxthon ==

Maxthon propose plusieurs commandes pour améliorer la capacités des Plugins Script. Ces commandes peuvent être exécutées par l'intermédiaire de l'objet window.external. Certaines commandes nécessite un ID de sécurité généré au démarrage de Maxthon.

'''Comment obtenir l'ID de sécurité'''

1. Les Plugins Script de type Button penvent utiliser "%max_security_id" pour l'ID sécurité

2. Les Plugins Script de type Sidebar et les Plugins HTML de type Button doivent charger "max.src", un script généré par Maxthon. Ensuite "max_security_id" peut être utilisé :

<script src=max.src></script>

'''Référence des commandes des Plugins de Maxthon'''

Sauf indication contraire, les commandes suivantes sont applicables pour Maxthon 2.0 et Maxthon 1.X :

1. '''max_version''' - retourne le numéro de version de Maxthon

Exemple :
alert(external.max_version);

2. '''max_language_id''' - retourne l'ID de langue de Maxthon

Exemple :
alert(external.max_language_id);

Note : Maxthon 2.0 et Maxthon 1.X ont un format d'ID de langue différent

3. '''tab_count''' - retourne le nombre d'onglets ouvert dans Maxthon

Exemple :
alert(external.tab_count);

4. '''cur_sel''' - retourne l'index de l'onglet en cours de Maxthon

Exemple :
alert(external.cur_sel);

5. '''m2_plugin_folder( security_id , plugin_name )''' - retourne le chemin du dossier du Plugin spécifié

Exemple :
alert(external.m2_plugin_folder( %max_security_id , 'ViewSource!'));

6. '''m2_run_cmd( security_id , command_id )''' - exécute l'ID de la commande spécifiée

Exemple :
external. m2_run_cmd( %max_security_id , 32772 ));

Note: Maxthon 2.0 et Maxthon 1.X ont des ID de commande différent. Les ID des commandes se trouvent dans le fichier langue de Maxthon.

7. '''get_tab( security_id , tab_index )''' - retourne l'objet Window de l'onglet spécifié

Exemple :
var oWin=external.get_tab(%max_security_id, 0);
alert(oWin.document.URL);

8. '''activate_tab( security_id , tab_index )''' - active l'onglet spécifié

Exemple :
external.activate_tab(%max_security_id, 0);

9. '''close_tab( security_id , tab_index )''' - ferme l'onglet spécifié

Exemple :
external.close_tab(%max_security_id, 0);

10. '''readFile( security_id, plugin_name, file_name)''' - lit le contenu du fichier texte spécifié

Example :
var sText=external.readFile(%max_security_id, 'ViewPage', 'readme.txt');
alert(sText);

11. '''writeFile( security_id, plugin_name, file_name, content )''' - écrit le contenu dans le fichier texte spécifié

Exemple :
external.writeFile(%max_security_id, 'ViewPage', 'test.txt', 'Ceci est le contenu du fichier');

12. '''m2_readIni( security_id, plugin_name , file_name , section_name , key , default_value)''' - lit les données du fichier INI spécifié

Exemple :
var sDownloadTool=external.m2_readIni(%max_security_id, 'ViewPage', 'plugin.ini', 'Settings', 'Tool', '');
alert(sDownloadTool);

13. '''m2_writeIni( security_id , plugin_name , file_name , section_name , key , value )''' - écrit les données dans le fichier INI spécifié

Exemple :
external.m2_writeIni(%max_security_id, 'ViewPage', 'test.ini', 'Config', 'height', '100px');

14. '''max_modelessDialog( security_id , url , option , attr , window )''' - retourne une page de dialogue Web modale

Exemple :
var oDialog= external.max_modelessDialog( %max_security_id , 'blank.html', window , '', window );
var oDoc=oDialog.document;
oDoc.write('Testing');
oDoc.close();

15. '''max_activex(security_id ,program_id)''' - retourne l'objet ActiveX spécifié

Exemple :
var oWSH=external.max_activex(%max_security_id, 'WScript.Shell');
oWSH.run('notepad.exe');

16. '''m2_search_text(security_id)''' - retourne le texte de la barre d'adresses

Exemple :
alert(m2_search_text(%max_security_id));

17. '''max_callback(event_name)''' - une fonction qui est exécutée lorsque certains évênements de Maxthon se produisent (pour les Plugins HTML de type Button et les Plugins Script de type Sidebar)

Les Plugins HTML de type Button et les Plugins Script de type Sidebar peuvent utiliser la fonction max_callback pour réagir à certains évênements de Maxthon comme le changement d'onglet.

Exemple :
function max_callback(x){
if(x=='tab_change') alert('L'onglet en cours à changé.');
}

En testant le paramètre de la fonction max_callback, le Plugin peut récupérer les évênements suivants :

'''Plugins HTML de type Button'''

'''tab_change''' – après que l'onglet en cours soit changé

'''document_Complete''' - après que l'onglet en cours soit entièrement chargé

'''self_destroy''' - lorsque le html est déchargé, normalement lorsque Maxthon est fermé

'''Plugins Script de type Sidebar'''

'''sidebar_tab_change''' - après que l'onglet en cours soit changé

'''sidebar_activate''' - lorsque le Plugin Sidebar est activé

'''sidebar_deactivate''' - lorsque le Plugin Sidebar est désactivé

'''sidebar_unload''' - lorsque le Plugin Sidebar est déchargé (Maxthon est fermé)

18. '''max_getObj''' (pour Maxthon 2.0 seulement) - retourne plusieurs objets de Maxthon :

'''Info''' - information générale sur Maxthon

'''Adhunter''' – à propos du tueur de pubs

'''FavManager''' – à propos des Favoris

'''RssManager''' – à propos des flux RSS

'''PluginManager''' - à propos des Plugins, pour Maxthon 2.0.5 ou supérieur

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');

'''L'objet Info supporte les propriétés et mêthodes suivante :'''

Propriétés :

'''fileProxy''' - en lecture seul, retourne le chemin du document de configuration du Proxy utilisateur en cours.

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo.fileProxy);

'''folderUser''' - en lecture seul, retourne le chemin du dossier du profil de l'utilisateur en cours

Example :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo. folderUser);

Mêthodes :

'''getFolderPluginData(plugin_name)''' - obtient le chemin du dossier de stockage des données d'un Plugin pour l'utilisateur en cours et le Plugin indiqué

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo.getFolderPluginData('ViewSource!'));

'''L'object AdHunter supporte les mêthodes suivantes :'''

Méthodes :

'''reloadFilter(filter_name)''' – recharge le filtre de Maxthon spécifié (actuellement seulement les filtres de contenu) après avoir modifié le filtre en question

Exemple :
var oAdHunter=external.max_getObj(%max_security_id, 'AdHunter');
oAdHunter.reloadFilter('content');

'''enableFilter(filter_name, bEnable)''' – active ou désactive le filtre de 'contenu' ou de 'Popup' de Maxthon

Exemple :
var oAdHunter=external.max_getObj(%max_security_id, 'AdHunter');
oAdHunter.enableFilter ('content', false);

'''L'objet PluginManager supporte les mêthode suivantes :'''

'''getPluginFolder''' - retourne le chemin du dossier principal du Plugin de Maxthon

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getPluginFolder)

'''getCount''' - retourne le nombre de tous les Plugins installés, qu'ils soient activés ou désactivés

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getCount)

'''getList''' - retourne une liste qui contient des informations comme le nom, l'auteur, etc de tous les Plugins

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getList)

'''getPlugin(Index)''' - Index est un nombre, retourne les objets du Plugin correspondant

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
var oPlugin=oPluginManager.getPlugin(0);

'''L'objet Plugin retourné de getPlugin(Index) supporte les propriétés et mêthodes suivantes :'''

Propriétés :

'''title''' - lecture seule, retourne le nom du Plugin

Exemple :
alert(oPlugin.title);

'''folderName''' - lecture seule, retourne le nom du dossier du Plugin

Exemple :
alert(oPlugin.folderName);

'''fullPath''' - lecture seule, retourne le chemin complet du dossier du Plugin

Exemple :
alert(oPlugin.fullPath);

'''enable''' - lecture/écriture, retourne ou défini si le Plugin est actif

Exemple :
oPlugin.enable=false;
alert(oPlugin.enable);
oPlugin.enable=true;
alert(oPlugin.enable);

'''startAfterPageDone''' - lecture/écriture, retourne ou défini si le Plugin est en démarrage automatique

Exemple :
oPlugin.startAfterPageDone = true;
alert(oPlugin.startAfterPageDone);
oPlugin.startAfterPageDone = false;
alert(oPlugin.startAfterPageDone);

'''startAfterPageDoneUrl''' - lecture/écriture, retourne ou défini l'adresse où le Plugin sera démarré automatiquement

Exemple :
oPlugin.startAfterPageDoneUrl='*maxthon.com*|*maxthon.cn*';
alert(oPlugin.startAfterPageDoneUrl);

Mêthodes :

'''config()''' - ouvre la boîte de dialogue de configuration du Plugin (config.html)

Exemple :
oPlugin.config();

'''remove()''' - supprime le Plugin

Exemple :
oPlugin.remove();

== Mscript ==

Maxthon 2.0 supporte des mscript personnalisés en plus des scripts pour les Plugins de type Button. Contrairement au script normaux, les mscript ne sont pas exécutés sur des pages Web et aisni les mscript ne sont pas sujet aux restrictions de sécurité imposées au scripts normaux, et on ne doit pas craindre qu'ils soient exploités par des pages Web. Les mscript peuvent grandement améliorer les fonctionnalités des Plugins depuis que les mscript peuvent fonctionner avec les scripts désactivés et les mscript peuvent accéder aux contenus des frames à travers les domaines. Pour utiliser mscript dans un Plugin de type Button, remplacez la balise <script...> par <mscript...>

Exemple - le Plugin de type Button peut désactiver les script dans la page en cours en modifiant le contrôle de contenu de Maxthon :

<script language="javascript">
external.m2_run_cmd(%max_security_id, 33175);
</script>

Mais après que les scripts soient désactivés, le Plugin ne peut plus fonctionner. Ainsi il ne pourra plus réactiver les scripts dans la pages en cours. D'autre part, le Plugin mscript suivant peut fonctionner avec les scripts désactivés, ainsi il pourra réactiver les scripts dans la page en cours.

<mscript language="javascript">
external.m2_run_cmd(0, 33175);
</script>

Notez qu'un nombre arbitraire peut être utilisé comme %max_security_id lorsque le mscript est utilisé.

<center>[[Base de connaissances de Maxthon 2.0]]</center>

Les scripts de Maxthon v2.0

2008-10-02T12:49:47Z

Ray1 : /* '''Types de Plugin de Maxthon''' */

== '''Types de Plugin de Maxthon''' ==

Le type de Plugin de Maxthon est défini par ModuleType (Script, HTML, COM et EXE) et Type (Button, Sidebar, Toolbar, COM_Button, MHO, MHO_Button) simultanément :

Button SideBar Toolbar COM_Button MHO MHO_Button
Script oui oui
HTML oui
EXE oui
COM oui oui oui oui oui oui
COM_Global oui oui oui oui

==== '''1. ModuleType - Script, HTML, EXE, COM et COM_Global''' ====

'''Script''' - Le Plugin Script peut être de type button, qui exécute un script lorsqu'il est cliqué. le script peut être dans un langage supporté par IE, comme le JavaScript ou le vbscript. Maxthon 2.0 supporte le mscript qui exécute l'environnement (plus de détails ci-après). Le Script peut également être de type sidebar, qui affiche un fichier HTML dans la barre latérale.

'''HTML''' - Un nouveau type de Plugin pour Maxthon 2.0 seulement. Le Plugin de type HTML est similaire au Plugin Script Sidebar dans sa nature. La différence majeure est que le Plugin Script Sidebar est affiché dans la barre latérale de Maxthon alors que le Plugin HTML est affiché comme un bouton dans la barre des Plugins ou n'importe quelle barre d'outils (barre d'état, barre des menus, barre des onglets, barre d'adresses...).

'''EXE''' - Le Plugin EXE sera affiché comme un bouton sur la barre des Plugins. Le Plugin EXE peut être n'importe quel fichier exécutable. Maxthon peut passer plusieurs paramètres au fichier exécutable comme l'URL de la page Web en cours ou le "handle" de la fenêtre de Maxthon.

'''COM''' - Le Plugin COM peut-être écrit en n'importe quel langage de programmation supporté par MSCOM, comme C++, Delphi, Visual Basic, C# etc. Les Plugins COM sont créés par onglet lors de la création d'un onglet (Types SideBar/Toolbar/MHO/COM_Button) ou lorsque le bouton du Plugin est cliqué (Type Button), et est détruit lorsque l'onglet est fermé. Un Plugin COM peut implémenter l'interface IObjectWithSite pour obtenir le pointeur "webbrowser" de l'onglet, l'événement du navigateur et le Document Object Model pour le manipuler.

'''COM_Global''' - Les Plugins COM_Global sont créés seulement une fois au démarrage de Maxthon, et sont détruits à la fermeture de Maxthon. Les Plugins COM_Global sont souvent pour les fonctions de navigation qui ne sont pas en relation avec le Document Object Model. Ainsi, les Plugins COM_Global peuvent implémenter une fonction PutMaxCommander à travers l'interface IDispatch pour obtenir un objet du Plugin de Maxthon, qui peut être utilisé de la même façon qu'un objet externe de Maxthon pour les Plugins script (cf. les commandes ci-dessous des Plugins script), pour interagir avec le Document Object Model des onglets et Maxthon.

Notez que Maxthon 2.0 est "multithread" (un "thread" pour chaque onglet). Les Plugins développés pour une interaction approfondie avec le Document Object Model des onglets doivent être développés en COM (par onglet) au lieu de COM_Global ainsi ils pourront fonctionner plus efficacement avec le même "thread" d'un onglet individuel.

==== '''2. Type - Button, SideBar, Toolbar, COM_Button, MHO, and MHO_Button''' ====

'''Button''' - Un bouton sera ajouté sur la barre des Plugins. L'opération spécifiée par le script (Plugin Script), l'exécutable (Plugin EXE), la DLL (Plugin COM) sera exécutée lorsque le bouton sera cliqué. Optionnellement, Les Plugins de bouton peuvent implémenter un menu déroulant pour le Plugin. Un Plugin de bouton COM doit implémenter l'interface IOleCommandTarget pour recevoir le clic du bouton. Si un menu est implémenté, la fonction IOleCommandTarget_Exec recevra un id de commande de 1 lorsque le bouton est cliqué, et un id de commande de 2 lorsque le premier menu est cliqué, etc. Un Plugin de bouton COM est crée lorsque le bouton est cliqué et est détruit lorsque l'onglet est fermé (comme IE7).

'''SideBar''' - Un bouton sera ajouté à la barre latérale, et un élément sera ajouté au menu principal > Affichage > Barre latérale. Lorsque le bouton ou l’élément du menu est cliqué, la barre latérale de Maxthon s'ouvrira et affichera le fichier HTML spécifié par le Plugin (Plugin script), ou la fenêtre spécifiée par le Plugin à travers l'interface IDeskBand (Plugin com ou com_global).

'''Toolbar''' - Les Plugins de barre d'outils doivent être écrits en COM. Une nouvelle barre d'outils sera ajoutée, qui pourra être affichée ou cachée à partir du menu principal > Affichage > Barre d'outils. Un Plugin de barre d'outils doit implémenter l'interface IDeskBand pour spécifier la fenêtre de la barre d'outils. Les Plugins de barre d'outils peuvent être COM ou COM_Global. Les Plugin de barre d'outils COM sont crées par onglet lorsque l'onglet est crée, et sont détruit lorsque l'onglet est fermé. Cela permet l'adoption de certaines barres d'outils d'IE dans Maxthon avec le minimum ou aucun changement. Les barres d'outils COM_Global sont crées seulement au démarrage de Maxthon, et sont détruit à la fermeture de Maxthon. Si une barre d'outils COM_Global implémente l'interface IObjectWithSite, elle peut obtenir le pointeur sur webbrowser de l'onglet actif à travers SetSite. Lorsque l'onglet actif est modifié, SetSite sera appelé de nouveau pour passer le pointeur sur webbrowser du nouvel onglet actif.

'''COM_Button''' - Les Plugins COM_Button sont identiques au Plugins de barre d'outils, à l'exception près que les Plugins COM_Button sont affichés dans Maxthon comme un bouton, et non pas comme une barre d'outils. Un Plugin COM_Button a la flexibilité de positionnement dans l'interface de Maxthon comme les autres boutons, mais il supporte également l'amélioration de l'interface d'une barre d'outils par rapport à un bouton.

'''MHO''' - Un Plugin MHO est identique au Browser Helper Object d'IE et doit être écrit en COM. Les Plugins MHO sont créés par onglet lorsque l'onglet est créé, et sont détruit lorsque l'onglet est fermé. Les Plugins MHO doivent implémenter l'interface IObjectWithSite pour obtenir un pointeur sur webbrowser de l'onglet pour interagir avec le DOM. Les Plugins MHO n'ont pas d'interface.

'''MHO_Button''' - Le Plugin MHO est une combinaison d'un Plugin MHO et d'un Plugin bouton COM. Les Plugins MHO_Button sont créés par onglet lorsque l'onglet est créé, et sont détruit lorsque l'onglet est fermé. En plus, une instance de Plugin MHO_Button sera créée lorsque son bouton est cliqué, et l'instance sera détruite lorsque l'opération est terminée. Le Plugin MHO_Button ajoute essentiellement une interface bouton au Plugin MHO.

== Créer un Plugin pour Maxthon ==

'''Composants majeurs dun Plugin de Maxthon'''

Un Plugin de Maxthon contient généralement les fichiers suivants :

'''Fichiers INI''' – Le fichier plugin.ini est nécessaire pour tous les Plugins de Maxthon. Il définit plusieurs attributs du Plugin.

'''Fichiers HTML/DLL/EXE file''' – Le composant principal nécessaire à tous les Plugins de Maxthon spécifiant l'operation à réaliser ou le contenu à afficher.

'''Fichier Icônes''' – L'icône du bouton (*.ICO) nécessaire aux Plugins bouton et barre latérale. Le Plugin COM et EXE peut avoir besoins d'icônes dans ces propres ressources.

'''Config.html''' – Un fichier HTML optionnel pour être utilisé avec les Plugins de type Script et HTML comme boîte de dialogue de configuration.

'''Fichier plugin.ini'''

[General] nécessaire à la définition de plusieurs attributs du plugin

'''Name'''= nom du Plugin

'''Author'''= nom de l'auteur

'''Version'''= Version du Plugin

'''ModuleType'''= Peut être Script, HTML, EXE, COM, or COM_Global

'''FileName'''= Peut être un fichier HTML (Plugins Script et HTML), un fichier DLL (Plugins COM) ou un fichier EXE (Plugins EXE)

'''Comments'''= La description affichée dans les options du Plugin et/ou l'info-bulle du Plugin de type Button

'''Type'''= Peut être M2Plugin_Button, M2Plugin_Sidebar, M2Plugin_Toolbar, M2Plugin_COM_Button, M2Plugin_MHO, ou M2Plugin_MHO_Button

'''IdealSize'''= La largeur et la hauteur de l'interface du Plugin (ex. 120 20, pour un Plugin HTML seulement)

'''IdealSizeVertical'''= La largeur et la hauteur de l'interface du Plugin lorsqu'il est eancré verticalement (ex 120 20, optionnel pour un Plugin HTML)

'''Icon'''= L'icône du bouton pour les Plugins de type Button ou Sidebar

'''HotIcon'''= L'icône du bouton lorsque le bouton du Plugin est survolé

'''CLSID'''= Le CSLID pour les Plugins de type COM et COM_Global

'''DefaultLocation'''= Optionnel, défini la localisation par défaut de l'icône du Plugin, peut être '''None''' (dans la barre des Plugins mais non affichée après l'installation, l'utilisateur peut afficher le bouton à partir du menu Afficher ou masquer des boutons), '''MenuBar''', '''ToolBar''', ou '''StatusBar'''. Si il n'est pas défini, le Plugin sera affiché dans la barre des Plugins. Pour le Plugin de type '''Button''' et pour Maxthon 2.0.5 ou supérieur.

'''StartAfterPageDoneURL'''= Optionnel, défini les adresses où le Plugin doit démarrer automatiquement, supporte les caractères jocker, et on peut utiliser "|" pour séparer les adresses, ex. '''*maxthon.com*|forum.maxthon.cn*'''. Si il n'est pas défini, le Plugin démarrera pour toutes les adresses, équivalent à '''*'''. Pour les Plugins de types '''Script''' et '''Button''' et pour Maxthon 2.0.5 ou supérieur.

'''StartAfterPageDoneURLExclude'''= Optionnel, défini où le Plugin ne doit pas démarrer automatiquement, a une priorité supérieure à startAfterPageDoneUrl. Utilise le même format que startAfterPageDoneUrl ex. '''forum.maxthon.cn/index.php?|*.maxthon.cn/index.php?showtopic*'''. Pour les Plugins de types '''Script''' et '''Button''' et pour Maxthon 2.0.5 ou supérieur.

[MyIE2Buttons] Optionnel pour définir le menu déroulant pour les Plugins de types Button et MHO_Button

'''Count'''= Le nombre d'éléments du menu déroulant

'''Name1'''= Le nom du 1er élément du menu déroulant

'''FileName1'''= Le nom du fichier, ou le nom du fichier + les paramètres pour les Plugins de type EXE, du 1er élément du menu déroulant. Pour les Plugins de type COM Button et COM MHO_Button, mettre un nom arbitraire et distinct, ex. 1 pour FileName1 et 2 pour FileName2 etc

'''Installation d'un Plugin de Maxthon'''

Les Plugins de Maxthon sont installés dans le répertoire "Plugin" du dossier d'installation de Maxthon. Chaque Plugin possède son propre dossier dédié qui contient le fichier plugin.ini et les autres fichiers nécessaires et/ou sous-dossiers.

Un Plugin terminé, comprenant le dossier du Plugin et tous les fichiers et/ou sous-dossiers peut être compressé dans un fichier ZIP (*.zip) pour être distribué.

'''Maxthon 2.0'''

Maxthon 2.0 supporte un pack d'installation M2P de plugins (essentiellement un *.zip renommé en *.m2p. Le Plugin sera installé lorsque le fichier M2P est double cliqué ou glissé/déplacé dans la fenêtre de Maxthon.

'''Maxthon 1.X'''

Les Plugins sont installés dans Maxthon 1.x en suivant cette procédure :

1. Fermer Maxthon

2. Extraire le fichier zip du Plugin dans le dossier "Plugin" du répertoire d'installation de Maxthon. En général, le fichier plugin.ini devrait se trouver dans C:\Program Files\Maxthon\Plugin\NewPlugin\plugin.ini

3. Ouvrir Maxthon, la fenêtre d'installation du Plugin devrait s'afficher

4. Confirmer l'installation du nouveau plugin

== Commandes des Plugins Script de Maxthon ==

Maxthon propose plusieurs commandes pour améliorer la capacités des Plugins Script. Ces commandes peuvent être exécutées par l'intermédiaire de l'objet window.external. Certaines commandes nécessite un ID de sécurité généré au démarrage de Maxthon.

'''Comment obtenir l'ID de sécurité'''

1. Les Plugins Script de type Button penvent utiliser "%max_security_id" pour l'ID sécurité

2. Les Plugins Script de type Sidebar et les Plugins HTML de type Button doivent charger "max.src", un script généré par Maxthon. Ensuite "max_security_id" peut être utilisé :

<script src=max.src></script>

'''Référence des commandes des Plugins de Maxthon'''

Sauf indication contraire, les commandes suivantes sont applicables pour Maxthon 2.0 et Maxthon 1.X :

1. '''max_version''' - retourne le numéro de version de Maxthon

Exemple :
alert(external.max_version);

2. '''max_language_id''' - retourne l'ID de langue de Maxthon

Exemple :
alert(external.max_language_id);

Note : Maxthon 2.0 et Maxthon 1.X ont un format d'ID de langue différent

3. '''tab_count''' - retourne le nombre d'onglets ouvert dans Maxthon

Exemple :
alert(external.tab_count);

4. '''cur_sel''' - retourne l'index de l'onglet en cours de Maxthon

Exemple :
alert(external.cur_sel);

5. '''m2_plugin_folder( security_id , plugin_name )''' - retourne le chemin du dossier du Plugin spécifié

Exemple :
alert(external.m2_plugin_folder( %max_security_id , 'ViewSource!'));

6. '''m2_run_cmd( security_id , command_id )''' - exécute l'ID de la commande spécifiée

Exemple :
external. m2_run_cmd( %max_security_id , 32772 ));

Note: Maxthon 2.0 et Maxthon 1.X ont des ID de commande différent. Les ID des commandes se trouvent dans le fichier langue de Maxthon.

7. '''get_tab( security_id , tab_index )''' - retourne l'objet Window de l'onglet spécifié

Exemple :
var oWin=external.get_tab(%max_security_id, 0);
alert(oWin.document.URL);

8. '''activate_tab( security_id , tab_index )''' - active l'onglet spécifié

Exemple :
external.activate_tab(%max_security_id, 0);

9. '''close_tab( security_id , tab_index )''' - ferme l'onglet spécifié

Exemple :
external.close_tab(%max_security_id, 0);

10. '''readFile( security_id, plugin_name, file_name)''' - lit le contenu du fichier texte spécifié

Example :
var sText=external.readFile(%max_security_id, 'ViewPage', 'readme.txt');
alert(sText);

11. '''writeFile( security_id, plugin_name, file_name, content )''' - écrit le contenu dans le fichier texte spécifié

Exemple :
external.writeFile(%max_security_id, 'ViewPage', 'test.txt', 'Ceci est le contenu du fichier');

12. '''m2_readIni( security_id, plugin_name , file_name , section_name , key , default_value)''' - lit les données du fichier INI spécifié

Exemple :
var sDownloadTool=external.m2_readIni(%max_security_id, 'ViewPage', 'plugin.ini', 'Settings', 'Tool', '');
alert(sDownloadTool);

13. '''m2_writeIni( security_id , plugin_name , file_name , section_name , key , value )''' - écrit les données dans le fichier INI spécifié

Exemple :
external.m2_writeIni(%max_security_id, 'ViewPage', 'test.ini', 'Config', 'height', '100px');

14. '''max_modelessDialog( security_id , url , option , attr , window )''' - retourne une page de dialogue Web modale

Exemple :
var oDialog= external.max_modelessDialog( %max_security_id , 'blank.html', window , '', window );
var oDoc=oDialog.document;
oDoc.write('Testing');
oDoc.close();

15. '''max_activex(security_id ,program_id)''' - retourne l'objet ActiveX spécifié

Exemple :
var oWSH=external.max_activex(%max_security_id, 'WScript.Shell');
oWSH.run('notepad.exe');

16. '''m2_search_text(security_id)''' - retourne le texte de la barre d'adresses

Exemple :
alert(m2_search_text(%max_security_id));

17. '''max_callback(event_name)''' - une fonction qui est exécutée lorsque certains évênements de Maxthon se produisent (pour les Plugins HTML de type Button et les Plugins Script de type Sidebar)

Les Plugins HTML de type Button et les Plugins Script de type Sidebar peuvent utiliser la fonction max_callback pour réagir à certains évênements de Maxthon comme le changement d'onglet.

Exemple :
function max_callback(x){
if(x=='tab_change') alert('L'onglet en cours à changé.');
}

En testant le paramètre de la fonction max_callback, le Plugin peut récupérer les évênements suivants :

'''Plugins HTML de type Button'''

'''tab_change''' – après que l'onglet en cours soit changé

'''document_Complete''' - après que l'onglet en cours soit entièrement chargé

'''self_destroy''' - lorsque le html est déchargé, normalement lorsque Maxthon est fermé

'''Plugins Script de type Sidebar'''

'''sidebar_tab_change''' - après que l'onglet en cours soit changé

'''sidebar_activate''' - lorsque le Plugin Sidebar est activé

'''sidebar_deactivate''' - lorsque le Plugin Sidebar est désactivé

'''sidebar_unload''' - lorsque le Plugin Sidebar est déchargé (Maxthon est fermé)

18. '''max_getObj''' (pour Maxthon 2.0 seulement) - retourne plusieurs objets de Maxthon :

'''Info''' - information générale sur Maxthon

'''Adhunter''' – à propos du tueur de pubs

'''FavManager''' – à propos des Favoris

'''RssManager''' – à propos des flux RSS

'''PluginManager''' - à propos des Plugins, pour Maxthon 2.0.5 ou supérieur

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');

'''L'objet Info supporte les propriétés et mêthodes suivante :'''

Propriétés :

'''fileProxy''' - en lecture seul, retourne le chemin du document de configuration du Proxy utilisateur en cours.

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo.fileProxy);

'''folderUser''' - en lecture seul, retourne le chemin du dossier du profil de l'utilisateur en cours

Example :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo. folderUser);

Mêthodes :

'''getFolderPluginData(plugin_name)''' - obtient le chemin du dossier de stockage des données d'un Plugin pour l'utilisateur en cours et le Plugin indiqué

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo.getFolderPluginData('ViewSource!'));

'''L'object AdHunter supporte les mêthodes suivantes :'''

Méthodes :

'''reloadFilter(filter_name)''' – recharge le filtre de Maxthon spécifié (actuellement seulement les filtres de contenu) après avoir modifié le filtre en question

Exemple :
var oAdHunter=external.max_getObj(%max_security_id, 'AdHunter');
oAdHunter.reloadFilter('content');

'''enableFilter(filter_name, bEnable)''' – active ou désactive le filtre de 'contenu' ou de 'Popup' de Maxthon

Exemple :
var oAdHunter=external.max_getObj(%max_security_id, 'AdHunter');
oAdHunter.enableFilter ('content', false);

'''L'objet PluginManager supporte les mêthode suivantes :'''

'''getPluginFolder''' - retourne le chemin du dossier principal du Plugin de Maxthon

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getPluginFolder)

'''getCount''' - retourne le nombre de tous les Plugins installés, qu'ils soient activés ou désactivés

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getCount)

'''getList''' - retourne une liste qui contient des informations comme le nom, l'auteur, etc de tous les Plugins

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getList)

'''getPlugin(Index)''' - Index est un nombre, retourne les objets du Plugin correspondant

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
var oPlugin=oPluginManager.getPlugin(0);

'''L'objet Plugin retourné de getPlugin(Index) supporte les propriétés et mêthodes suivantes :'''

Propriétés :

'''title''' - lecture seule, retourne le nom du Plugin

Exemple :
alert(oPlugin.title);

'''folderName''' - lecture seule, retourne le nom du dossier du Plugin

Exemple :
alert(oPlugin.folderName);

'''fullPath''' - lecture seule, retourne le chemin complet du dossier du Plugin

Exemple :
alert(oPlugin.fullPath);

'''enable''' - lecture/écriture, retourne ou défini si le Plugin est actif

Exemple :
oPlugin.enable=false;
alert(oPlugin.enable);
oPlugin.enable=true;
alert(oPlugin.enable);

'''startAfterPageDone''' - lecture/écriture, retourne ou défini si le Plugin est en démarrage automatique

Exemple :
oPlugin.startAfterPageDone = true;
alert(oPlugin.startAfterPageDone);
oPlugin.startAfterPageDone = false;
alert(oPlugin.startAfterPageDone);

'''startAfterPageDoneUrl''' - lecture/écriture, retourne ou défini l'adresse où le Plugin sera démarré automatiquement

Exemple :
oPlugin.startAfterPageDoneUrl='*maxthon.com*|*maxthon.cn*';
alert(oPlugin.startAfterPageDoneUrl);

Mêthodes :

'''config()''' - ouvre la boîte de dialogue de configuration du Plugin (config.html)

Exemple :
oPlugin.config();

'''remove()''' - supprime le Plugin

Exemple :
oPlugin.remove();

== Mscript ==

Maxthon 2.0 supporte des mscript personnalisés en plus des scripts pour les Plugins de type Button. Contrairement au script normaux, les mscript ne sont pas exécutés sur des pages Web et aisni les mscript ne sont pas sujet aux restrictions de sécurité imposées au scripts normaux, et on ne doit pas craindre qu'ils soient exploités par des pages Web. Les mscript peuvent grandement améliorer les fonctionnalités des Plugins depuis que les mscript peuvent fonctionner avec les scripts désactivés et les mscript peuvent accéder aux contenus des frames à travers les domaines. Pour utiliser mscript dans un Plugin de type Button, remplacez la balise <script...> par <mscript...>

Exemple - le Plugin de type Button peut désactiver les script dans la page en cours en modifiant le contrôle de contenu de Maxthon :

<script language="javascript">
external.m2_run_cmd(%max_security_id, 33175);
</script>

Mais après que les scripts soient désactivés, le Plugin ne peut plus fonctionner. Ainsi il ne pourra plus réactiver les scripts dans la pages en cours. D'autre part, le Plugin mscript suivant peut fonctionner avec les scripts désactivés, ainsi il pourra réactiver les scripts dans la page en cours.

<mscript language="javascript">
external.m2_run_cmd(0, 33175);
</script>

Notez qu'un nombre arbitraire peut être utilisé comme %max_security_id lorsque le mscript est utilisé.

<center>[[Base de connaissances de Maxthon 2.0]]</center>

Les scripts de Maxthon v2.0

2008-10-02T12:48:30Z

Ray1 : /* '''1. ModuleType - Script, HTML, EXE, COM et COM_Global''' */

== '''Types de Plugin de Maxthon''' ==

Le type de Plugin de Maxthon est défini par ModuleType (Script, HTML, COM et EXE) et Type (Button, Sidebar, Toolbar, COM_Button, MHO, MHO_Button) simultanément :

Button SideBar Toolbar COM_Button MHO MHO_Button
Script oui oui
HTML oui
EXE oui
COM oui oui oui oui oui oui
COM_Global oui oui oui oui

==== '''1. ModuleType - Script, HTML, EXE, COM et COM_Global''' ====

'''Script''' - Le Plugin Script peut être de type button, qui exécute un script lorsqu'il est cliqué. le script peut être dans un langage supporté par IE, comme le JavaScript ou le vbscript. Maxthon 2.0 supporte le mscript qui exécute l'environnement (plus de détails ci-après). Le Script peut également être de type sidebar, qui affiche un fichier HTML dans la barre latérale.

'''HTML''' - Un nouveau type de Plugin pour Maxthon 2.0 seulement. Le Plugin de type HTML est similaire au Plugin Script Sidebar dans sa nature. La différence majeure est que le Plugin Script Sidebar est affiché dans la barre latérale de Maxthon alors que le Plugin HTML est affiché comme un bouton dans la barre des Plugins ou n'importe quelle barre d'outils (barre d'état, barre des menus, barre des onglets, barre d'adresses...).

'''EXE''' - Le Plugin EXE sera affiché comme un bouton sur la barre des Plugins. Le Plugin EXE peut être n'importe quel fichier exécutable. Maxthon peut passer plusieurs paramètres au fichier exécutable comme l'URL de la page Web en cours ou le "handle" de la fenêtre de Maxthon.

'''COM''' - Le Plugin COM peut-être écrit en n'importe quel langage de programmation supporté par MSCOM, comme C++, Delphi, Visual Basic, C# etc. Les Plugins COM sont créés par onglet lors de la création d'un onglet (Types SideBar/Toolbar/MHO/COM_Button) ou lorsque le bouton du Plugin est cliqué (Type Button), et est détruit lorsque l'onglet est fermé. Un Plugin COM peut implémenter l'interface IObjectWithSite pour obtenir le pointeur "webbrowser" de l'onglet, l'événement du navigateur et le Document Object Model pour le manipuler.

'''COM_Global''' - Les Plugins COM_Global sont créés seulement une fois au démarrage de Maxthon, et sont détruits à la fermeture de Maxthon. Les Plugins COM_Global sont souvent pour les fonctions de navigation qui ne sont pas en relation avec le Document Object Model. Ainsi, les Plugins COM_Global peuvent implémenter une fonction PutMaxCommander à travers l'interface IDispatch pour obtenir un objet du Plugin de Maxthon, qui peut être utilisé de la même façon qu'un objet externe de Maxthon pour les Plugins script (cf. les commandes ci-dessous des Plugins script), pour interagir avec le Document Object Model des onglets et Maxthon.

Notez que Maxthon 2.0 est "multithread" (un "thread" pour chaque onglet). Les Plugins développés pour une interaction approfondie avec le Document Object Model des onglets doivent être développés en COM (par onglet) au lieu de COM_Global ainsi ils pourront fonctionner plus efficacement avec le même "thread" d'un onglet individuel.

==== '''2. Type - Button, SideBar, Toolbar, COM_Button, MHO, and MHO_Button''' ====

'''Button''' - Un bouton sera ajouté sur la barre des Plugins. L'opération spécifiée par le script (Plugin Script), l'exécutable (Plugin EXE), la DLL (Plugin COM) sera exécutée lorsque le bouton sera cliqué. Optionnellement, Les Plugins de bouton peuvent implémenter un menu déroulant pour le Plugin. Un Plugin de bouton COM doit implémenter l'interface IOleCommandTarget pour recevoir le clic du bouton. Si un menu est implémenté, la fonction IOleCommandTarget_Exec recevra un id de commande de 1 lorsque le bouton est cliqué, et un id de commande de 2 lorsque le premier menu est cliqué, etc. Un Plugin de bouton COM est crée lorsque le bouton est cliqué et est détruit lorsque l'onglet est fermé (comme IE7).

'''SideBar''' - Un bouton sera ajouté à la barre latérale, et un élément sera ajouté au menu principal > Affichage > Barre latérale. Lorsque le bouton ou l’élément du menu est cliqué, la barre latérale de Maxthon s'ouvrira et affichera le fichier HTML spécifié par le Plugin (Plugin script), ou la fenêtre spécifiée par le Plugin à travers l'interface IDeskBand (Plugin com ou com_global).

'''Toolbar''' - Les Plugins de barre d'outils doivent être écrit en COM. Une nouvelle barre d'outils sera ajoutée, qui pourra être affichée ou cachée à partir du menu principal > Affichage > Barre d'outils. Un Plugin de barre d'outils doit implémenter l'interface IDeskBand pour spécifier la fenêtre de la barre d'outils. Les Plugins de barre d'outils peuvent être COM ou COM_Global. Les Plugin de barre d'outils COM sont crées par onglet lorsque l'onglet est crée, et sont détruit lorsque l'onglet est fermé. Cela permet l'adoption de certaines barres d'outils d'IE dans Maxthon avec le minimum ou aucun changement. Les barres d'outils COM_Global sont crées seulement au démarrage de Maxthon, et sont détruit à la fermeture de Maxthon. Si une barre d'outils COM_Global implémente l'interface IObjectWithSite, elle peut obtenir le pointeur sur webbrowser de l'onglet actif à travers SetSite. Lorsque l'onglet actif est modifié, SetSite sera appelé de nouveau pour passer le pointeur sur webbrowser du nouvel onglet actif.

'''COM_Button''' - Les Plugins COM_Button sont identiques au Plugins de barre d'outils, à l'exception près que les Plugins COM_Button sont affichés dans Maxthon comme un bouton, et non pas comme une barre d'outils. Un Plugin COM_Button a la flexibilité de positionnement dans l'interface de Maxthon comme les autres boutons, mais il supporte également l'amélioration de l'interface d'une barre d'outils par rapport à un bouton.

'''MHO''' - Un Plugin MHO est identique au Browser Helper Object d'IE et doit être écrit en COM. Les Plugins MHO sont créés par onglet lorsque l'onglet est créé, et sont détruit lorsque l'onglet est fermé. Les Plugins MHO doivent implémenter l'interface IObjectWithSite pour obtenir un pointeur sur webbrowser de l'onglet pour interagir avec le DOM. Les Plugins MHO n'ont pas d'interface.

'''MHO_Button''' - Le Plugin MHO est une combinaison d'un Plugin MHO et d'un Plugin bouton COM. Les Plugins MHO_Button sont créés par onglet lorsque l'onglet est créé, et sont détruit lorsque l'onglet est fermé. En plus, une instance de Plugin MHO_Button sera créée lorsque son bouton est cliqué, et l'instance Sera détruite lorsque l'opération est terminée. Le Plugin MHO_Button ajoute essentiellement une interface bouton au Plugin MHO.

== Créer un Plugin pour Maxthon ==

'''Composants majeurs dun Plugin de Maxthon'''

Un Plugin de Maxthon contient généralement les fichiers suivants :

'''Fichiers INI''' – Le fichier plugin.ini est nécessaire pour tous les Plugins de Maxthon. Il définit plusieurs attributs du Plugin.

'''Fichiers HTML/DLL/EXE file''' – Le composant principal nécessaire à tous les Plugins de Maxthon spécifiant l'operation à réaliser ou le contenu à afficher.

'''Fichier Icônes''' – L'icône du bouton (*.ICO) nécessaire aux Plugins bouton et barre latérale. Le Plugin COM et EXE peut avoir besoins d'icônes dans ces propres ressources.

'''Config.html''' – Un fichier HTML optionnel pour être utilisé avec les Plugins de type Script et HTML comme boîte de dialogue de configuration.

'''Fichier plugin.ini'''

[General] nécessaire à la définition de plusieurs attributs du plugin

'''Name'''= nom du Plugin

'''Author'''= nom de l'auteur

'''Version'''= Version du Plugin

'''ModuleType'''= Peut être Script, HTML, EXE, COM, or COM_Global

'''FileName'''= Peut être un fichier HTML (Plugins Script et HTML), un fichier DLL (Plugins COM) ou un fichier EXE (Plugins EXE)

'''Comments'''= La description affichée dans les options du Plugin et/ou l'info-bulle du Plugin de type Button

'''Type'''= Peut être M2Plugin_Button, M2Plugin_Sidebar, M2Plugin_Toolbar, M2Plugin_COM_Button, M2Plugin_MHO, ou M2Plugin_MHO_Button

'''IdealSize'''= La largeur et la hauteur de l'interface du Plugin (ex. 120 20, pour un Plugin HTML seulement)

'''IdealSizeVertical'''= La largeur et la hauteur de l'interface du Plugin lorsqu'il est eancré verticalement (ex 120 20, optionnel pour un Plugin HTML)

'''Icon'''= L'icône du bouton pour les Plugins de type Button ou Sidebar

'''HotIcon'''= L'icône du bouton lorsque le bouton du Plugin est survolé

'''CLSID'''= Le CSLID pour les Plugins de type COM et COM_Global

'''DefaultLocation'''= Optionnel, défini la localisation par défaut de l'icône du Plugin, peut être '''None''' (dans la barre des Plugins mais non affichée après l'installation, l'utilisateur peut afficher le bouton à partir du menu Afficher ou masquer des boutons), '''MenuBar''', '''ToolBar''', ou '''StatusBar'''. Si il n'est pas défini, le Plugin sera affiché dans la barre des Plugins. Pour le Plugin de type '''Button''' et pour Maxthon 2.0.5 ou supérieur.

'''StartAfterPageDoneURL'''= Optionnel, défini les adresses où le Plugin doit démarrer automatiquement, supporte les caractères jocker, et on peut utiliser "|" pour séparer les adresses, ex. '''*maxthon.com*|forum.maxthon.cn*'''. Si il n'est pas défini, le Plugin démarrera pour toutes les adresses, équivalent à '''*'''. Pour les Plugins de types '''Script''' et '''Button''' et pour Maxthon 2.0.5 ou supérieur.

'''StartAfterPageDoneURLExclude'''= Optionnel, défini où le Plugin ne doit pas démarrer automatiquement, a une priorité supérieure à startAfterPageDoneUrl. Utilise le même format que startAfterPageDoneUrl ex. '''forum.maxthon.cn/index.php?|*.maxthon.cn/index.php?showtopic*'''. Pour les Plugins de types '''Script''' et '''Button''' et pour Maxthon 2.0.5 ou supérieur.

[MyIE2Buttons] Optionnel pour définir le menu déroulant pour les Plugins de types Button et MHO_Button

'''Count'''= Le nombre d'éléments du menu déroulant

'''Name1'''= Le nom du 1er élément du menu déroulant

'''FileName1'''= Le nom du fichier, ou le nom du fichier + les paramètres pour les Plugins de type EXE, du 1er élément du menu déroulant. Pour les Plugins de type COM Button et COM MHO_Button, mettre un nom arbitraire et distinct, ex. 1 pour FileName1 et 2 pour FileName2 etc

'''Installation d'un Plugin de Maxthon'''

Les Plugins de Maxthon sont installés dans le répertoire "Plugin" du dossier d'installation de Maxthon. Chaque Plugin possède son propre dossier dédié qui contient le fichier plugin.ini et les autres fichiers nécessaires et/ou sous-dossiers.

Un Plugin terminé, comprenant le dossier du Plugin et tous les fichiers et/ou sous-dossiers peut être compressé dans un fichier ZIP (*.zip) pour être distribué.

'''Maxthon 2.0'''

Maxthon 2.0 supporte un pack d'installation M2P de plugins (essentiellement un *.zip renommé en *.m2p. Le Plugin sera installé lorsque le fichier M2P est double cliqué ou glissé/déplacé dans la fenêtre de Maxthon.

'''Maxthon 1.X'''

Les Plugins sont installés dans Maxthon 1.x en suivant cette procédure :

1. Fermer Maxthon

2. Extraire le fichier zip du Plugin dans le dossier "Plugin" du répertoire d'installation de Maxthon. En général, le fichier plugin.ini devrait se trouver dans C:\Program Files\Maxthon\Plugin\NewPlugin\plugin.ini

3. Ouvrir Maxthon, la fenêtre d'installation du Plugin devrait s'afficher

4. Confirmer l'installation du nouveau plugin

== Commandes des Plugins Script de Maxthon ==

Maxthon propose plusieurs commandes pour améliorer la capacités des Plugins Script. Ces commandes peuvent être exécutées par l'intermédiaire de l'objet window.external. Certaines commandes nécessite un ID de sécurité généré au démarrage de Maxthon.

'''Comment obtenir l'ID de sécurité'''

1. Les Plugins Script de type Button penvent utiliser "%max_security_id" pour l'ID sécurité

2. Les Plugins Script de type Sidebar et les Plugins HTML de type Button doivent charger "max.src", un script généré par Maxthon. Ensuite "max_security_id" peut être utilisé :

<script src=max.src></script>

'''Référence des commandes des Plugins de Maxthon'''

Sauf indication contraire, les commandes suivantes sont applicables pour Maxthon 2.0 et Maxthon 1.X :

1. '''max_version''' - retourne le numéro de version de Maxthon

Exemple :
alert(external.max_version);

2. '''max_language_id''' - retourne l'ID de langue de Maxthon

Exemple :
alert(external.max_language_id);

Note : Maxthon 2.0 et Maxthon 1.X ont un format d'ID de langue différent

3. '''tab_count''' - retourne le nombre d'onglets ouvert dans Maxthon

Exemple :
alert(external.tab_count);

4. '''cur_sel''' - retourne l'index de l'onglet en cours de Maxthon

Exemple :
alert(external.cur_sel);

5. '''m2_plugin_folder( security_id , plugin_name )''' - retourne le chemin du dossier du Plugin spécifié

Exemple :
alert(external.m2_plugin_folder( %max_security_id , 'ViewSource!'));

6. '''m2_run_cmd( security_id , command_id )''' - exécute l'ID de la commande spécifiée

Exemple :
external. m2_run_cmd( %max_security_id , 32772 ));

Note: Maxthon 2.0 et Maxthon 1.X ont des ID de commande différent. Les ID des commandes se trouvent dans le fichier langue de Maxthon.

7. '''get_tab( security_id , tab_index )''' - retourne l'objet Window de l'onglet spécifié

Exemple :
var oWin=external.get_tab(%max_security_id, 0);
alert(oWin.document.URL);

8. '''activate_tab( security_id , tab_index )''' - active l'onglet spécifié

Exemple :
external.activate_tab(%max_security_id, 0);

9. '''close_tab( security_id , tab_index )''' - ferme l'onglet spécifié

Exemple :
external.close_tab(%max_security_id, 0);

10. '''readFile( security_id, plugin_name, file_name)''' - lit le contenu du fichier texte spécifié

Example :
var sText=external.readFile(%max_security_id, 'ViewPage', 'readme.txt');
alert(sText);

11. '''writeFile( security_id, plugin_name, file_name, content )''' - écrit le contenu dans le fichier texte spécifié

Exemple :
external.writeFile(%max_security_id, 'ViewPage', 'test.txt', 'Ceci est le contenu du fichier');

12. '''m2_readIni( security_id, plugin_name , file_name , section_name , key , default_value)''' - lit les données du fichier INI spécifié

Exemple :
var sDownloadTool=external.m2_readIni(%max_security_id, 'ViewPage', 'plugin.ini', 'Settings', 'Tool', '');
alert(sDownloadTool);

13. '''m2_writeIni( security_id , plugin_name , file_name , section_name , key , value )''' - écrit les données dans le fichier INI spécifié

Exemple :
external.m2_writeIni(%max_security_id, 'ViewPage', 'test.ini', 'Config', 'height', '100px');

14. '''max_modelessDialog( security_id , url , option , attr , window )''' - retourne une page de dialogue Web modale

Exemple :
var oDialog= external.max_modelessDialog( %max_security_id , 'blank.html', window , '', window );
var oDoc=oDialog.document;
oDoc.write('Testing');
oDoc.close();

15. '''max_activex(security_id ,program_id)''' - retourne l'objet ActiveX spécifié

Exemple :
var oWSH=external.max_activex(%max_security_id, 'WScript.Shell');
oWSH.run('notepad.exe');

16. '''m2_search_text(security_id)''' - retourne le texte de la barre d'adresses

Exemple :
alert(m2_search_text(%max_security_id));

17. '''max_callback(event_name)''' - une fonction qui est exécutée lorsque certains évênements de Maxthon se produisent (pour les Plugins HTML de type Button et les Plugins Script de type Sidebar)

Les Plugins HTML de type Button et les Plugins Script de type Sidebar peuvent utiliser la fonction max_callback pour réagir à certains évênements de Maxthon comme le changement d'onglet.

Exemple :
function max_callback(x){
if(x=='tab_change') alert('L'onglet en cours à changé.');
}

En testant le paramètre de la fonction max_callback, le Plugin peut récupérer les évênements suivants :

'''Plugins HTML de type Button'''

'''tab_change''' – après que l'onglet en cours soit changé

'''document_Complete''' - après que l'onglet en cours soit entièrement chargé

'''self_destroy''' - lorsque le html est déchargé, normalement lorsque Maxthon est fermé

'''Plugins Script de type Sidebar'''

'''sidebar_tab_change''' - après que l'onglet en cours soit changé

'''sidebar_activate''' - lorsque le Plugin Sidebar est activé

'''sidebar_deactivate''' - lorsque le Plugin Sidebar est désactivé

'''sidebar_unload''' - lorsque le Plugin Sidebar est déchargé (Maxthon est fermé)

18. '''max_getObj''' (pour Maxthon 2.0 seulement) - retourne plusieurs objets de Maxthon :

'''Info''' - information générale sur Maxthon

'''Adhunter''' – à propos du tueur de pubs

'''FavManager''' – à propos des Favoris

'''RssManager''' – à propos des flux RSS

'''PluginManager''' - à propos des Plugins, pour Maxthon 2.0.5 ou supérieur

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');

'''L'objet Info supporte les propriétés et mêthodes suivante :'''

Propriétés :

'''fileProxy''' - en lecture seul, retourne le chemin du document de configuration du Proxy utilisateur en cours.

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo.fileProxy);

'''folderUser''' - en lecture seul, retourne le chemin du dossier du profil de l'utilisateur en cours

Example :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo. folderUser);

Mêthodes :

'''getFolderPluginData(plugin_name)''' - obtient le chemin du dossier de stockage des données d'un Plugin pour l'utilisateur en cours et le Plugin indiqué

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo.getFolderPluginData('ViewSource!'));

'''L'object AdHunter supporte les mêthodes suivantes :'''

Méthodes :

'''reloadFilter(filter_name)''' – recharge le filtre de Maxthon spécifié (actuellement seulement les filtres de contenu) après avoir modifié le filtre en question

Exemple :
var oAdHunter=external.max_getObj(%max_security_id, 'AdHunter');
oAdHunter.reloadFilter('content');

'''enableFilter(filter_name, bEnable)''' – active ou désactive le filtre de 'contenu' ou de 'Popup' de Maxthon

Exemple :
var oAdHunter=external.max_getObj(%max_security_id, 'AdHunter');
oAdHunter.enableFilter ('content', false);

'''L'objet PluginManager supporte les mêthode suivantes :'''

'''getPluginFolder''' - retourne le chemin du dossier principal du Plugin de Maxthon

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getPluginFolder)

'''getCount''' - retourne le nombre de tous les Plugins installés, qu'ils soient activés ou désactivés

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getCount)

'''getList''' - retourne une liste qui contient des informations comme le nom, l'auteur, etc de tous les Plugins

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getList)

'''getPlugin(Index)''' - Index est un nombre, retourne les objets du Plugin correspondant

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
var oPlugin=oPluginManager.getPlugin(0);

'''L'objet Plugin retourné de getPlugin(Index) supporte les propriétés et mêthodes suivantes :'''

Propriétés :

'''title''' - lecture seule, retourne le nom du Plugin

Exemple :
alert(oPlugin.title);

'''folderName''' - lecture seule, retourne le nom du dossier du Plugin

Exemple :
alert(oPlugin.folderName);

'''fullPath''' - lecture seule, retourne le chemin complet du dossier du Plugin

Exemple :
alert(oPlugin.fullPath);

'''enable''' - lecture/écriture, retourne ou défini si le Plugin est actif

Exemple :
oPlugin.enable=false;
alert(oPlugin.enable);
oPlugin.enable=true;
alert(oPlugin.enable);

'''startAfterPageDone''' - lecture/écriture, retourne ou défini si le Plugin est en démarrage automatique

Exemple :
oPlugin.startAfterPageDone = true;
alert(oPlugin.startAfterPageDone);
oPlugin.startAfterPageDone = false;
alert(oPlugin.startAfterPageDone);

'''startAfterPageDoneUrl''' - lecture/écriture, retourne ou défini l'adresse où le Plugin sera démarré automatiquement

Exemple :
oPlugin.startAfterPageDoneUrl='*maxthon.com*|*maxthon.cn*';
alert(oPlugin.startAfterPageDoneUrl);

Mêthodes :

'''config()''' - ouvre la boîte de dialogue de configuration du Plugin (config.html)

Exemple :
oPlugin.config();

'''remove()''' - supprime le Plugin

Exemple :
oPlugin.remove();

== Mscript ==

Maxthon 2.0 supporte des mscript personnalisés en plus des scripts pour les Plugins de type Button. Contrairement au script normaux, les mscript ne sont pas exécutés sur des pages Web et aisni les mscript ne sont pas sujet aux restrictions de sécurité imposées au scripts normaux, et on ne doit pas craindre qu'ils soient exploités par des pages Web. Les mscript peuvent grandement améliorer les fonctionnalités des Plugins depuis que les mscript peuvent fonctionner avec les scripts désactivés et les mscript peuvent accéder aux contenus des frames à travers les domaines. Pour utiliser mscript dans un Plugin de type Button, remplacez la balise <script...> par <mscript...>

Exemple - le Plugin de type Button peut désactiver les script dans la page en cours en modifiant le contrôle de contenu de Maxthon :

<script language="javascript">
external.m2_run_cmd(%max_security_id, 33175);
</script>

Mais après que les scripts soient désactivés, le Plugin ne peut plus fonctionner. Ainsi il ne pourra plus réactiver les scripts dans la pages en cours. D'autre part, le Plugin mscript suivant peut fonctionner avec les scripts désactivés, ainsi il pourra réactiver les scripts dans la page en cours.

<mscript language="javascript">
external.m2_run_cmd(0, 33175);
</script>

Notez qu'un nombre arbitraire peut être utilisé comme %max_security_id lorsque le mscript est utilisé.

<center>[[Base de connaissances de Maxthon 2.0]]</center>

Les scripts de Maxthon v2.0

2008-10-02T12:46:26Z

Ray1 : /* '''2. Type - Button, SideBar, Toolbar, COM_Button, MHO, and MHO_Button''' */

== '''Types de Plugin de Maxthon''' ==

Le type de Plugin de Maxthon est défini par ModuleType (Script, HTML, COM et EXE) et Type (Button, Sidebar, Toolbar, COM_Button, MHO, MHO_Button) simultanément :

Button SideBar Toolbar COM_Button MHO MHO_Button
Script oui oui
HTML oui
EXE oui
COM oui oui oui oui oui oui
COM_Global oui oui oui oui

==== '''1. ModuleType - Script, HTML, EXE, COM et COM_Global''' ====

'''Script''' - Le Plugin Script peut être de type button, qui exécute un script lorsqu'il est cliqué. le script peut être dans un langage supporté par IE, comme le JavaScript ou le vbscript. Maxthon 2.0 supporte le mscript qui exécute l'environnent (plus de détails ci-après). Le Script peut également être de type sidebar, qui affiche un fichier HTML dans la barre latérale.

'''HTML''' - Un nouveau type de Plugin pour Maxthon 2.0 seulement. Le Plugin de type HTML est similaire au Plugin Script Sidebar dans sa nature. La différence majeure est que le Plugin Script Sidebar est affiché dans la barre latérale de Maxthon alors que le Plugin HTML est affiché comme un bouton dans la barre des Plugins ou n'importe quelle barre d'outils (barre d'état, barre des menus, barre des onglets, barre d'adresses...).

'''EXE''' - Le Plugin EXE sera affiché comme un bouton sur la barre des Plugins. Le Plugin EXE peut être n'importe quel fichier exécutable. Maxthon peut passer plusieurs paramètres au fichier exécutable comme l'url de la page Web en cours ou le "handle" de la fenêtre de Maxthon.

'''COM''' - Le Plugin COM peut être écrit en n'importe quel langage de programmation supporté par MSCOM, comme C++, Delphi, Visual Basic, C# etc. Les Plugins COM sont créés par onglet lors de la création d'un onglet (Types SideBar/Toolbar/MHO/COM_Button) ou lorsque le bouton du Plugin est cliqué (Type Button), et est détruit lorsque l'onglet est fermé. Un Plugin COM peut implémenter l'interface IObjectWithSite pour obtenir le pointeur "webbrowser" de l'onglet, l'événement du navigateur et le Document Object Model pour le manipuler.

'''COM_Global''' - Les Plugins COM_Global sont crées seulement une fois au démarrage de Maxthon, et sont détruits à la fermeture de Maxthon. Les Plugins COM_Global sont souvent pour les fonctions de navigation qui ne sont pas en relation avec le Document Object Model. Ainsi les Plugins COM_Global peuvent implémenter une fonction PutMaxCommander à travers l'interface IDispatch pour obtenir un objet du Plugin de Maxthon, qui peut être utilisé de la même façon qu'un objet externe de Maxthon pour les Plugins script (cf. les commandes ci-dessous des Plugins script), pour interagir avec le Document Object Model des onglets et Maxthon.

Notez que Maxthon 2.0 est "multithread" (un "thread" pour chaque onglet). Les Plugins développés pour une interaction approfondie avec le Document Object Model des onglets doivent être développés en COM (par onglet) au lieu de COM_Global ainsi ils pourront fonctionner plus efficacement avec le même "thread" d'un onglet individuel.

==== '''2. Type - Button, SideBar, Toolbar, COM_Button, MHO, and MHO_Button''' ====

'''Button''' - Un bouton sera ajouté sur la barre des Plugins. L'opération spécifiée par le script (Plugin Script), l'exécutable (Plugin EXE), la DLL (Plugin COM) sera exécutée lorsque le bouton sera cliqué. Optionnellement, Les Plugins de bouton peuvent implémenter un menu déroulant pour le Plugin. Un Plugin de bouton COM doit implémenter l'interface IOleCommandTarget pour recevoir le clic du bouton. Si un menu est implémenté, la fonction IOleCommandTarget_Exec recevra un id de commande de 1 lorsque le bouton est cliqué, et un id de commande de 2 lorsque le premier menu est cliqué, etc. Un Plugin de bouton COM est crée lorsque le bouton est cliqué et est détruit lorsque l'onglet est fermé (comme IE7).

'''SideBar''' - Un bouton sera ajouté à la barre latérale, et un élément sera ajouté au menu principal > Affichage > Barre latérale. Lorsque le bouton ou l’élément du menu est cliqué, la barre latérale de Maxthon s'ouvrira et affichera le fichier HTML spécifié par le Plugin (Plugin script), ou la fenêtre spécifiée par le Plugin à travers l'interface IDeskBand (Plugin com ou com_global).

'''Toolbar''' - Les Plugins de barre d'outils doivent être écrit en COM. Une nouvelle barre d'outils sera ajoutée, qui pourra être affichée ou cachée à partir du menu principal > Affichage > Barre d'outils. Un Plugin de barre d'outils doit implémenter l'interface IDeskBand pour spécifier la fenêtre de la barre d'outils. Les Plugins de barre d'outils peuvent être COM ou COM_Global. Les Plugin de barre d'outils COM sont crées par onglet lorsque l'onglet est crée, et sont détruit lorsque l'onglet est fermé. Cela permet l'adoption de certaines barres d'outils d'IE dans Maxthon avec le minimum ou aucun changement. Les barres d'outils COM_Global sont crées seulement au démarrage de Maxthon, et sont détruit à la fermeture de Maxthon. Si une barre d'outils COM_Global implémente l'interface IObjectWithSite, elle peut obtenir le pointeur sur webbrowser de l'onglet actif à travers SetSite. Lorsque l'onglet actif est modifié, SetSite sera appelé de nouveau pour passer le pointeur sur webbrowser du nouvel onglet actif.

'''COM_Button''' - Les Plugins COM_Button sont identiques au Plugins de barre d'outils, à l'exception près que les Plugins COM_Button sont affichés dans Maxthon comme un bouton, et non pas comme une barre d'outils. Un Plugin COM_Button a la flexibilité de positionnement dans l'interface de Maxthon comme les autres boutons, mais il supporte également l'amélioration de l'interface d'une barre d'outils par rapport à un bouton.

'''MHO''' - Un Plugin MHO est identique au Browser Helper Object d'IE et doit être écrit en COM. Les Plugins MHO sont créés par onglet lorsque l'onglet est créé, et sont détruit lorsque l'onglet est fermé. Les Plugins MHO doivent implémenter l'interface IObjectWithSite pour obtenir un pointeur sur webbrowser de l'onglet pour interagir avec le DOM. Les Plugins MHO n'ont pas d'interface.

'''MHO_Button''' - Le Plugin MHO est une combinaison d'un Plugin MHO et d'un Plugin bouton COM. Les Plugins MHO_Button sont créés par onglet lorsque l'onglet est créé, et sont détruit lorsque l'onglet est fermé. En plus, une instance de Plugin MHO_Button sera créée lorsque son bouton est cliqué, et l'instance Sera détruite lorsque l'opération est terminée. Le Plugin MHO_Button ajoute essentiellement une interface bouton au Plugin MHO.

== Créer un Plugin pour Maxthon ==

'''Composants majeurs dun Plugin de Maxthon'''

Un Plugin de Maxthon contient généralement les fichiers suivants :

'''Fichiers INI''' – Le fichier plugin.ini est nécessaire pour tous les Plugins de Maxthon. Il définit plusieurs attributs du Plugin.

'''Fichiers HTML/DLL/EXE file''' – Le composant principal nécessaire à tous les Plugins de Maxthon spécifiant l'operation à réaliser ou le contenu à afficher.

'''Fichier Icônes''' – L'icône du bouton (*.ICO) nécessaire aux Plugins bouton et barre latérale. Le Plugin COM et EXE peut avoir besoins d'icônes dans ces propres ressources.

'''Config.html''' – Un fichier HTML optionnel pour être utilisé avec les Plugins de type Script et HTML comme boîte de dialogue de configuration.

'''Fichier plugin.ini'''

[General] nécessaire à la définition de plusieurs attributs du plugin

'''Name'''= nom du Plugin

'''Author'''= nom de l'auteur

'''Version'''= Version du Plugin

'''ModuleType'''= Peut être Script, HTML, EXE, COM, or COM_Global

'''FileName'''= Peut être un fichier HTML (Plugins Script et HTML), un fichier DLL (Plugins COM) ou un fichier EXE (Plugins EXE)

'''Comments'''= La description affichée dans les options du Plugin et/ou l'info-bulle du Plugin de type Button

'''Type'''= Peut être M2Plugin_Button, M2Plugin_Sidebar, M2Plugin_Toolbar, M2Plugin_COM_Button, M2Plugin_MHO, ou M2Plugin_MHO_Button

'''IdealSize'''= La largeur et la hauteur de l'interface du Plugin (ex. 120 20, pour un Plugin HTML seulement)

'''IdealSizeVertical'''= La largeur et la hauteur de l'interface du Plugin lorsqu'il est eancré verticalement (ex 120 20, optionnel pour un Plugin HTML)

'''Icon'''= L'icône du bouton pour les Plugins de type Button ou Sidebar

'''HotIcon'''= L'icône du bouton lorsque le bouton du Plugin est survolé

'''CLSID'''= Le CSLID pour les Plugins de type COM et COM_Global

'''DefaultLocation'''= Optionnel, défini la localisation par défaut de l'icône du Plugin, peut être '''None''' (dans la barre des Plugins mais non affichée après l'installation, l'utilisateur peut afficher le bouton à partir du menu Afficher ou masquer des boutons), '''MenuBar''', '''ToolBar''', ou '''StatusBar'''. Si il n'est pas défini, le Plugin sera affiché dans la barre des Plugins. Pour le Plugin de type '''Button''' et pour Maxthon 2.0.5 ou supérieur.

'''StartAfterPageDoneURL'''= Optionnel, défini les adresses où le Plugin doit démarrer automatiquement, supporte les caractères jocker, et on peut utiliser "|" pour séparer les adresses, ex. '''*maxthon.com*|forum.maxthon.cn*'''. Si il n'est pas défini, le Plugin démarrera pour toutes les adresses, équivalent à '''*'''. Pour les Plugins de types '''Script''' et '''Button''' et pour Maxthon 2.0.5 ou supérieur.

'''StartAfterPageDoneURLExclude'''= Optionnel, défini où le Plugin ne doit pas démarrer automatiquement, a une priorité supérieure à startAfterPageDoneUrl. Utilise le même format que startAfterPageDoneUrl ex. '''forum.maxthon.cn/index.php?|*.maxthon.cn/index.php?showtopic*'''. Pour les Plugins de types '''Script''' et '''Button''' et pour Maxthon 2.0.5 ou supérieur.

[MyIE2Buttons] Optionnel pour définir le menu déroulant pour les Plugins de types Button et MHO_Button

'''Count'''= Le nombre d'éléments du menu déroulant

'''Name1'''= Le nom du 1er élément du menu déroulant

'''FileName1'''= Le nom du fichier, ou le nom du fichier + les paramètres pour les Plugins de type EXE, du 1er élément du menu déroulant. Pour les Plugins de type COM Button et COM MHO_Button, mettre un nom arbitraire et distinct, ex. 1 pour FileName1 et 2 pour FileName2 etc

'''Installation d'un Plugin de Maxthon'''

Les Plugins de Maxthon sont installés dans le répertoire "Plugin" du dossier d'installation de Maxthon. Chaque Plugin possède son propre dossier dédié qui contient le fichier plugin.ini et les autres fichiers nécessaires et/ou sous-dossiers.

Un Plugin terminé, comprenant le dossier du Plugin et tous les fichiers et/ou sous-dossiers peut être compressé dans un fichier ZIP (*.zip) pour être distribué.

'''Maxthon 2.0'''

Maxthon 2.0 supporte un pack d'installation M2P de plugins (essentiellement un *.zip renommé en *.m2p. Le Plugin sera installé lorsque le fichier M2P est double cliqué ou glissé/déplacé dans la fenêtre de Maxthon.

'''Maxthon 1.X'''

Les Plugins sont installés dans Maxthon 1.x en suivant cette procédure :

1. Fermer Maxthon

2. Extraire le fichier zip du Plugin dans le dossier "Plugin" du répertoire d'installation de Maxthon. En général, le fichier plugin.ini devrait se trouver dans C:\Program Files\Maxthon\Plugin\NewPlugin\plugin.ini

3. Ouvrir Maxthon, la fenêtre d'installation du Plugin devrait s'afficher

4. Confirmer l'installation du nouveau plugin

== Commandes des Plugins Script de Maxthon ==

Maxthon propose plusieurs commandes pour améliorer la capacités des Plugins Script. Ces commandes peuvent être exécutées par l'intermédiaire de l'objet window.external. Certaines commandes nécessite un ID de sécurité généré au démarrage de Maxthon.

'''Comment obtenir l'ID de sécurité'''

1. Les Plugins Script de type Button penvent utiliser "%max_security_id" pour l'ID sécurité

2. Les Plugins Script de type Sidebar et les Plugins HTML de type Button doivent charger "max.src", un script généré par Maxthon. Ensuite "max_security_id" peut être utilisé :

<script src=max.src></script>

'''Référence des commandes des Plugins de Maxthon'''

Sauf indication contraire, les commandes suivantes sont applicables pour Maxthon 2.0 et Maxthon 1.X :

1. '''max_version''' - retourne le numéro de version de Maxthon

Exemple :
alert(external.max_version);

2. '''max_language_id''' - retourne l'ID de langue de Maxthon

Exemple :
alert(external.max_language_id);

Note : Maxthon 2.0 et Maxthon 1.X ont un format d'ID de langue différent

3. '''tab_count''' - retourne le nombre d'onglets ouvert dans Maxthon

Exemple :
alert(external.tab_count);

4. '''cur_sel''' - retourne l'index de l'onglet en cours de Maxthon

Exemple :
alert(external.cur_sel);

5. '''m2_plugin_folder( security_id , plugin_name )''' - retourne le chemin du dossier du Plugin spécifié

Exemple :
alert(external.m2_plugin_folder( %max_security_id , 'ViewSource!'));

6. '''m2_run_cmd( security_id , command_id )''' - exécute l'ID de la commande spécifiée

Exemple :
external. m2_run_cmd( %max_security_id , 32772 ));

Note: Maxthon 2.0 et Maxthon 1.X ont des ID de commande différent. Les ID des commandes se trouvent dans le fichier langue de Maxthon.

7. '''get_tab( security_id , tab_index )''' - retourne l'objet Window de l'onglet spécifié

Exemple :
var oWin=external.get_tab(%max_security_id, 0);
alert(oWin.document.URL);

8. '''activate_tab( security_id , tab_index )''' - active l'onglet spécifié

Exemple :
external.activate_tab(%max_security_id, 0);

9. '''close_tab( security_id , tab_index )''' - ferme l'onglet spécifié

Exemple :
external.close_tab(%max_security_id, 0);

10. '''readFile( security_id, plugin_name, file_name)''' - lit le contenu du fichier texte spécifié

Example :
var sText=external.readFile(%max_security_id, 'ViewPage', 'readme.txt');
alert(sText);

11. '''writeFile( security_id, plugin_name, file_name, content )''' - écrit le contenu dans le fichier texte spécifié

Exemple :
external.writeFile(%max_security_id, 'ViewPage', 'test.txt', 'Ceci est le contenu du fichier');

12. '''m2_readIni( security_id, plugin_name , file_name , section_name , key , default_value)''' - lit les données du fichier INI spécifié

Exemple :
var sDownloadTool=external.m2_readIni(%max_security_id, 'ViewPage', 'plugin.ini', 'Settings', 'Tool', '');
alert(sDownloadTool);

13. '''m2_writeIni( security_id , plugin_name , file_name , section_name , key , value )''' - écrit les données dans le fichier INI spécifié

Exemple :
external.m2_writeIni(%max_security_id, 'ViewPage', 'test.ini', 'Config', 'height', '100px');

14. '''max_modelessDialog( security_id , url , option , attr , window )''' - retourne une page de dialogue Web modale

Exemple :
var oDialog= external.max_modelessDialog( %max_security_id , 'blank.html', window , '', window );
var oDoc=oDialog.document;
oDoc.write('Testing');
oDoc.close();

15. '''max_activex(security_id ,program_id)''' - retourne l'objet ActiveX spécifié

Exemple :
var oWSH=external.max_activex(%max_security_id, 'WScript.Shell');
oWSH.run('notepad.exe');

16. '''m2_search_text(security_id)''' - retourne le texte de la barre d'adresses

Exemple :
alert(m2_search_text(%max_security_id));

17. '''max_callback(event_name)''' - une fonction qui est exécutée lorsque certains évênements de Maxthon se produisent (pour les Plugins HTML de type Button et les Plugins Script de type Sidebar)

Les Plugins HTML de type Button et les Plugins Script de type Sidebar peuvent utiliser la fonction max_callback pour réagir à certains évênements de Maxthon comme le changement d'onglet.

Exemple :
function max_callback(x){
if(x=='tab_change') alert('L'onglet en cours à changé.');
}

En testant le paramètre de la fonction max_callback, le Plugin peut récupérer les évênements suivants :

'''Plugins HTML de type Button'''

'''tab_change''' – après que l'onglet en cours soit changé

'''document_Complete''' - après que l'onglet en cours soit entièrement chargé

'''self_destroy''' - lorsque le html est déchargé, normalement lorsque Maxthon est fermé

'''Plugins Script de type Sidebar'''

'''sidebar_tab_change''' - après que l'onglet en cours soit changé

'''sidebar_activate''' - lorsque le Plugin Sidebar est activé

'''sidebar_deactivate''' - lorsque le Plugin Sidebar est désactivé

'''sidebar_unload''' - lorsque le Plugin Sidebar est déchargé (Maxthon est fermé)

18. '''max_getObj''' (pour Maxthon 2.0 seulement) - retourne plusieurs objets de Maxthon :

'''Info''' - information générale sur Maxthon

'''Adhunter''' – à propos du tueur de pubs

'''FavManager''' – à propos des Favoris

'''RssManager''' – à propos des flux RSS

'''PluginManager''' - à propos des Plugins, pour Maxthon 2.0.5 ou supérieur

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');

'''L'objet Info supporte les propriétés et mêthodes suivante :'''

Propriétés :

'''fileProxy''' - en lecture seul, retourne le chemin du document de configuration du Proxy utilisateur en cours.

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo.fileProxy);

'''folderUser''' - en lecture seul, retourne le chemin du dossier du profil de l'utilisateur en cours

Example :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo. folderUser);

Mêthodes :

'''getFolderPluginData(plugin_name)''' - obtient le chemin du dossier de stockage des données d'un Plugin pour l'utilisateur en cours et le Plugin indiqué

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo.getFolderPluginData('ViewSource!'));

'''L'object AdHunter supporte les mêthodes suivantes :'''

Méthodes :

'''reloadFilter(filter_name)''' – recharge le filtre de Maxthon spécifié (actuellement seulement les filtres de contenu) après avoir modifié le filtre en question

Exemple :
var oAdHunter=external.max_getObj(%max_security_id, 'AdHunter');
oAdHunter.reloadFilter('content');

'''enableFilter(filter_name, bEnable)''' – active ou désactive le filtre de 'contenu' ou de 'Popup' de Maxthon

Exemple :
var oAdHunter=external.max_getObj(%max_security_id, 'AdHunter');
oAdHunter.enableFilter ('content', false);

'''L'objet PluginManager supporte les mêthode suivantes :'''

'''getPluginFolder''' - retourne le chemin du dossier principal du Plugin de Maxthon

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getPluginFolder)

'''getCount''' - retourne le nombre de tous les Plugins installés, qu'ils soient activés ou désactivés

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getCount)

'''getList''' - retourne une liste qui contient des informations comme le nom, l'auteur, etc de tous les Plugins

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getList)

'''getPlugin(Index)''' - Index est un nombre, retourne les objets du Plugin correspondant

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
var oPlugin=oPluginManager.getPlugin(0);

'''L'objet Plugin retourné de getPlugin(Index) supporte les propriétés et mêthodes suivantes :'''

Propriétés :

'''title''' - lecture seule, retourne le nom du Plugin

Exemple :
alert(oPlugin.title);

'''folderName''' - lecture seule, retourne le nom du dossier du Plugin

Exemple :
alert(oPlugin.folderName);

'''fullPath''' - lecture seule, retourne le chemin complet du dossier du Plugin

Exemple :
alert(oPlugin.fullPath);

'''enable''' - lecture/écriture, retourne ou défini si le Plugin est actif

Exemple :
oPlugin.enable=false;
alert(oPlugin.enable);
oPlugin.enable=true;
alert(oPlugin.enable);

'''startAfterPageDone''' - lecture/écriture, retourne ou défini si le Plugin est en démarrage automatique

Exemple :
oPlugin.startAfterPageDone = true;
alert(oPlugin.startAfterPageDone);
oPlugin.startAfterPageDone = false;
alert(oPlugin.startAfterPageDone);

'''startAfterPageDoneUrl''' - lecture/écriture, retourne ou défini l'adresse où le Plugin sera démarré automatiquement

Exemple :
oPlugin.startAfterPageDoneUrl='*maxthon.com*|*maxthon.cn*';
alert(oPlugin.startAfterPageDoneUrl);

Mêthodes :

'''config()''' - ouvre la boîte de dialogue de configuration du Plugin (config.html)

Exemple :
oPlugin.config();

'''remove()''' - supprime le Plugin

Exemple :
oPlugin.remove();

== Mscript ==

Maxthon 2.0 supporte des mscript personnalisés en plus des scripts pour les Plugins de type Button. Contrairement au script normaux, les mscript ne sont pas exécutés sur des pages Web et aisni les mscript ne sont pas sujet aux restrictions de sécurité imposées au scripts normaux, et on ne doit pas craindre qu'ils soient exploités par des pages Web. Les mscript peuvent grandement améliorer les fonctionnalités des Plugins depuis que les mscript peuvent fonctionner avec les scripts désactivés et les mscript peuvent accéder aux contenus des frames à travers les domaines. Pour utiliser mscript dans un Plugin de type Button, remplacez la balise <script...> par <mscript...>

Exemple - le Plugin de type Button peut désactiver les script dans la page en cours en modifiant le contrôle de contenu de Maxthon :

<script language="javascript">
external.m2_run_cmd(%max_security_id, 33175);
</script>

Mais après que les scripts soient désactivés, le Plugin ne peut plus fonctionner. Ainsi il ne pourra plus réactiver les scripts dans la pages en cours. D'autre part, le Plugin mscript suivant peut fonctionner avec les scripts désactivés, ainsi il pourra réactiver les scripts dans la page en cours.

<mscript language="javascript">
external.m2_run_cmd(0, 33175);
</script>

Notez qu'un nombre arbitraire peut être utilisé comme %max_security_id lorsque le mscript est utilisé.

<center>[[Base de connaissances de Maxthon 2.0]]</center>

Les scripts de Maxthon v2.0

2008-10-02T12:43:46Z

Ray1 : /* '''1. ModuleType - Script, HTML, EXE, COM et COM_Global''' */

== '''Types de Plugin de Maxthon''' ==

Le type de Plugin de Maxthon est défini par ModuleType (Script, HTML, COM et EXE) et Type (Button, Sidebar, Toolbar, COM_Button, MHO, MHO_Button) simultanément :

Button SideBar Toolbar COM_Button MHO MHO_Button
Script oui oui
HTML oui
EXE oui
COM oui oui oui oui oui oui
COM_Global oui oui oui oui

==== '''1. ModuleType - Script, HTML, EXE, COM et COM_Global''' ====

'''Script''' - Le Plugin Script peut être de type button, qui exécute un script lorsqu'il est cliqué. le script peut être dans un langage supporté par IE, comme le JavaScript ou le vbscript. Maxthon 2.0 supporte le mscript qui exécute l'environnent (plus de détails ci-après). Le Script peut également être de type sidebar, qui affiche un fichier HTML dans la barre latérale.

'''HTML''' - Un nouveau type de Plugin pour Maxthon 2.0 seulement. Le Plugin de type HTML est similaire au Plugin Script Sidebar dans sa nature. La différence majeure est que le Plugin Script Sidebar est affiché dans la barre latérale de Maxthon alors que le Plugin HTML est affiché comme un bouton dans la barre des Plugins ou n'importe quelle barre d'outils (barre d'état, barre des menus, barre des onglets, barre d'adresses...).

'''EXE''' - Le Plugin EXE sera affiché comme un bouton sur la barre des Plugins. Le Plugin EXE peut être n'importe quel fichier exécutable. Maxthon peut passer plusieurs paramètres au fichier exécutable comme l'url de la page Web en cours ou le "handle" de la fenêtre de Maxthon.

'''COM''' - Le Plugin COM peut être écrit en n'importe quel langage de programmation supporté par MSCOM, comme C++, Delphi, Visual Basic, C# etc. Les Plugins COM sont créés par onglet lors de la création d'un onglet (Types SideBar/Toolbar/MHO/COM_Button) ou lorsque le bouton du Plugin est cliqué (Type Button), et est détruit lorsque l'onglet est fermé. Un Plugin COM peut implémenter l'interface IObjectWithSite pour obtenir le pointeur "webbrowser" de l'onglet, l'événement du navigateur et le Document Object Model pour le manipuler.

'''COM_Global''' - Les Plugins COM_Global sont crées seulement une fois au démarrage de Maxthon, et sont détruits à la fermeture de Maxthon. Les Plugins COM_Global sont souvent pour les fonctions de navigation qui ne sont pas en relation avec le Document Object Model. Ainsi les Plugins COM_Global peuvent implémenter une fonction PutMaxCommander à travers l'interface IDispatch pour obtenir un objet du Plugin de Maxthon, qui peut être utilisé de la même façon qu'un objet externe de Maxthon pour les Plugins script (cf. les commandes ci-dessous des Plugins script), pour interagir avec le Document Object Model des onglets et Maxthon.

Notez que Maxthon 2.0 est "multithread" (un "thread" pour chaque onglet). Les Plugins développés pour une interaction approfondie avec le Document Object Model des onglets doivent être développés en COM (par onglet) au lieu de COM_Global ainsi ils pourront fonctionner plus efficacement avec le même "thread" d'un onglet individuel.

==== '''2. Type - Button, SideBar, Toolbar, COM_Button, MHO, and MHO_Button''' ====

'''Button''' - Un bouton sera ajouté sur la barre des Plugins. L'opération spécifiée par le script (Plugin Script), l'exécutable (Plugin EXE), la DLL (Plugin COM) sera exécutés lorsque le bouton sera cliqué. Optionnellement, Les Plugins de bouton peuvent implémenter un menu déroulant pour le Plugin. Un Plugin de bouton COM doit implémenter l'interface IOleCommandTarget pour recevoir le clic du bouton. Si un menu est implémenté, la fonction IOleCommandTarget_Exec recevra un id de commande de 1 lorsque le bouton est cliqué, et un id de commande de 2 lorsque le premier menu est cliqué, etc. Un Plugin de bouton COM est crée lorsque le bouton est cliqué et est détruit lorsque l'onglet est fermé (comme IE7).

'''SideBar''' - Un bouton sera ajouté à la barre latérale, et un élément sera ajouté au menu principal > Affichage > Barre latérale. Lorsque le bouton ou l’élément du menu est cliqué, La barre latérale de Maxthon s'ouvrira et affichera le fichier HTML spécifié par le Plugin (Plugin script), ou la fenêtre spécifiée par le Plugin à travers l'interface IDeskBand (Plugin com ou com_global).

'''Toolbar''' - Les Plugins de barre d'outils doivent être écris en COM. Un nouvelle barre d'outils sera ajoutée, qui pourra être affichée ou cachée à partir du menu principal > Affichage > Barre d'outils. Un Plugin de barre d'outils doit implémenter l'interface IDeskBand pour spécifier la fenêtre de la barre d'outils. Les Plugins de barre d'outils peuvent être COM ou COM_Global. Les Plugin de barre d'outils COM sont crées par onglet lorsque l'onglet est crée, et sont détruit lorsque l'onglet est fermé. Cela permet l'adoption de certaine barre d'outils d'IE dans Maxthon avec le minimum ou aucun changement. Les barres d'outils COM_Global sont crées seulement au démarrage de Maxthon, et sont détruis à la fermeture de Maxthon. Si une barre d'outils COM_Global implémente l'interface IObjectWithSite, elle peut obtenir le pointeur sur webbrowser de l'onglet actif à travers SetSite. Lorsque l'onglet actif est modifié, SetSite sera appelé de nouveau pour passer le pointeur sur webbrowser du nouvel onglet actif.

'''COM_Button''' - Les Plugins COM_Button sont identiques au Plugins de barre d'outils, à l'exception près que les Plugins COM_Button sont affichés dans Maxthon comme un bouton, et non pas comme une barre d'outils. Un Plugin COM_Button a la flexibilité de positionnement dans l'interface de Maxthon comme les autres boutons, mais il supporte également l'amélioration de l'interface d'une barre d'outils par rapport à un bouton.

'''MHO''' - Un Plugin MHO est identique au Browser Helper Object d'IE et doit être écrit en COM. Les Plugins MHO sont crées par onglet lorsque l'onglet est crée, et sont détruit lorsque l'onglet est fermé. Les Plugins MHO doivent implémenter l'interface IObjectWithSite pour obtenir un pointeur sur webbrowser de l'onglet pour interagir avec le DOM. Les Plugins MHO n'ont pas d'interface.

'''MHO_Button''' - Le Plugin MHO est une combinaison d'un Plugin MHO et d'un Plugin bouton COM. Les Plugins MHO_Button sont crées par onglet lorsque l'onglet est crée, et sont détruit lorsque l'onglet est fermé. En plus, une instance de Plugin MHO_Button sera crée lorsque son bouton est cliqué, et l'instance Sera détruite lorsque l'opération est terminée. Le Plugin MHO_Button ajoute essentiellement une interface bouton au Plugin MHO.

== Créer un Plugin pour Maxthon ==

'''Composants majeurs dun Plugin de Maxthon'''

Un Plugin de Maxthon contient généralement les fichiers suivants :

'''Fichiers INI''' – Le fichier plugin.ini est nécessaire pour tous les Plugins de Maxthon. Il définit plusieurs attributs du Plugin.

'''Fichiers HTML/DLL/EXE file''' – Le composant principal nécessaire à tous les Plugins de Maxthon spécifiant l'operation à réaliser ou le contenu à afficher.

'''Fichier Icônes''' – L'icône du bouton (*.ICO) nécessaire aux Plugins bouton et barre latérale. Le Plugin COM et EXE peut avoir besoins d'icônes dans ces propres ressources.

'''Config.html''' – Un fichier HTML optionnel pour être utilisé avec les Plugins de type Script et HTML comme boîte de dialogue de configuration.

'''Fichier plugin.ini'''

[General] nécessaire à la définition de plusieurs attributs du plugin

'''Name'''= nom du Plugin

'''Author'''= nom de l'auteur

'''Version'''= Version du Plugin

'''ModuleType'''= Peut être Script, HTML, EXE, COM, or COM_Global

'''FileName'''= Peut être un fichier HTML (Plugins Script et HTML), un fichier DLL (Plugins COM) ou un fichier EXE (Plugins EXE)

'''Comments'''= La description affichée dans les options du Plugin et/ou l'info-bulle du Plugin de type Button

'''Type'''= Peut être M2Plugin_Button, M2Plugin_Sidebar, M2Plugin_Toolbar, M2Plugin_COM_Button, M2Plugin_MHO, ou M2Plugin_MHO_Button

'''IdealSize'''= La largeur et la hauteur de l'interface du Plugin (ex. 120 20, pour un Plugin HTML seulement)

'''IdealSizeVertical'''= La largeur et la hauteur de l'interface du Plugin lorsqu'il est eancré verticalement (ex 120 20, optionnel pour un Plugin HTML)

'''Icon'''= L'icône du bouton pour les Plugins de type Button ou Sidebar

'''HotIcon'''= L'icône du bouton lorsque le bouton du Plugin est survolé

'''CLSID'''= Le CSLID pour les Plugins de type COM et COM_Global

'''DefaultLocation'''= Optionnel, défini la localisation par défaut de l'icône du Plugin, peut être '''None''' (dans la barre des Plugins mais non affichée après l'installation, l'utilisateur peut afficher le bouton à partir du menu Afficher ou masquer des boutons), '''MenuBar''', '''ToolBar''', ou '''StatusBar'''. Si il n'est pas défini, le Plugin sera affiché dans la barre des Plugins. Pour le Plugin de type '''Button''' et pour Maxthon 2.0.5 ou supérieur.

'''StartAfterPageDoneURL'''= Optionnel, défini les adresses où le Plugin doit démarrer automatiquement, supporte les caractères jocker, et on peut utiliser "|" pour séparer les adresses, ex. '''*maxthon.com*|forum.maxthon.cn*'''. Si il n'est pas défini, le Plugin démarrera pour toutes les adresses, équivalent à '''*'''. Pour les Plugins de types '''Script''' et '''Button''' et pour Maxthon 2.0.5 ou supérieur.

'''StartAfterPageDoneURLExclude'''= Optionnel, défini où le Plugin ne doit pas démarrer automatiquement, a une priorité supérieure à startAfterPageDoneUrl. Utilise le même format que startAfterPageDoneUrl ex. '''forum.maxthon.cn/index.php?|*.maxthon.cn/index.php?showtopic*'''. Pour les Plugins de types '''Script''' et '''Button''' et pour Maxthon 2.0.5 ou supérieur.

[MyIE2Buttons] Optionnel pour définir le menu déroulant pour les Plugins de types Button et MHO_Button

'''Count'''= Le nombre d'éléments du menu déroulant

'''Name1'''= Le nom du 1er élément du menu déroulant

'''FileName1'''= Le nom du fichier, ou le nom du fichier + les paramètres pour les Plugins de type EXE, du 1er élément du menu déroulant. Pour les Plugins de type COM Button et COM MHO_Button, mettre un nom arbitraire et distinct, ex. 1 pour FileName1 et 2 pour FileName2 etc

'''Installation d'un Plugin de Maxthon'''

Les Plugins de Maxthon sont installés dans le répertoire "Plugin" du dossier d'installation de Maxthon. Chaque Plugin possède son propre dossier dédié qui contient le fichier plugin.ini et les autres fichiers nécessaires et/ou sous-dossiers.

Un Plugin terminé, comprenant le dossier du Plugin et tous les fichiers et/ou sous-dossiers peut être compressé dans un fichier ZIP (*.zip) pour être distribué.

'''Maxthon 2.0'''

Maxthon 2.0 supporte un pack d'installation M2P de plugins (essentiellement un *.zip renommé en *.m2p. Le Plugin sera installé lorsque le fichier M2P est double cliqué ou glissé/déplacé dans la fenêtre de Maxthon.

'''Maxthon 1.X'''

Les Plugins sont installés dans Maxthon 1.x en suivant cette procédure :

1. Fermer Maxthon

2. Extraire le fichier zip du Plugin dans le dossier "Plugin" du répertoire d'installation de Maxthon. En général, le fichier plugin.ini devrait se trouver dans C:\Program Files\Maxthon\Plugin\NewPlugin\plugin.ini

3. Ouvrir Maxthon, la fenêtre d'installation du Plugin devrait s'afficher

4. Confirmer l'installation du nouveau plugin

== Commandes des Plugins Script de Maxthon ==

Maxthon propose plusieurs commandes pour améliorer la capacités des Plugins Script. Ces commandes peuvent être exécutées par l'intermédiaire de l'objet window.external. Certaines commandes nécessite un ID de sécurité généré au démarrage de Maxthon.

'''Comment obtenir l'ID de sécurité'''

1. Les Plugins Script de type Button penvent utiliser "%max_security_id" pour l'ID sécurité

2. Les Plugins Script de type Sidebar et les Plugins HTML de type Button doivent charger "max.src", un script généré par Maxthon. Ensuite "max_security_id" peut être utilisé :

<script src=max.src></script>

'''Référence des commandes des Plugins de Maxthon'''

Sauf indication contraire, les commandes suivantes sont applicables pour Maxthon 2.0 et Maxthon 1.X :

1. '''max_version''' - retourne le numéro de version de Maxthon

Exemple :
alert(external.max_version);

2. '''max_language_id''' - retourne l'ID de langue de Maxthon

Exemple :
alert(external.max_language_id);

Note : Maxthon 2.0 et Maxthon 1.X ont un format d'ID de langue différent

3. '''tab_count''' - retourne le nombre d'onglets ouvert dans Maxthon

Exemple :
alert(external.tab_count);

4. '''cur_sel''' - retourne l'index de l'onglet en cours de Maxthon

Exemple :
alert(external.cur_sel);

5. '''m2_plugin_folder( security_id , plugin_name )''' - retourne le chemin du dossier du Plugin spécifié

Exemple :
alert(external.m2_plugin_folder( %max_security_id , 'ViewSource!'));

6. '''m2_run_cmd( security_id , command_id )''' - exécute l'ID de la commande spécifiée

Exemple :
external. m2_run_cmd( %max_security_id , 32772 ));

Note: Maxthon 2.0 et Maxthon 1.X ont des ID de commande différent. Les ID des commandes se trouvent dans le fichier langue de Maxthon.

7. '''get_tab( security_id , tab_index )''' - retourne l'objet Window de l'onglet spécifié

Exemple :
var oWin=external.get_tab(%max_security_id, 0);
alert(oWin.document.URL);

8. '''activate_tab( security_id , tab_index )''' - active l'onglet spécifié

Exemple :
external.activate_tab(%max_security_id, 0);

9. '''close_tab( security_id , tab_index )''' - ferme l'onglet spécifié

Exemple :
external.close_tab(%max_security_id, 0);

10. '''readFile( security_id, plugin_name, file_name)''' - lit le contenu du fichier texte spécifié

Example :
var sText=external.readFile(%max_security_id, 'ViewPage', 'readme.txt');
alert(sText);

11. '''writeFile( security_id, plugin_name, file_name, content )''' - écrit le contenu dans le fichier texte spécifié

Exemple :
external.writeFile(%max_security_id, 'ViewPage', 'test.txt', 'Ceci est le contenu du fichier');

12. '''m2_readIni( security_id, plugin_name , file_name , section_name , key , default_value)''' - lit les données du fichier INI spécifié

Exemple :
var sDownloadTool=external.m2_readIni(%max_security_id, 'ViewPage', 'plugin.ini', 'Settings', 'Tool', '');
alert(sDownloadTool);

13. '''m2_writeIni( security_id , plugin_name , file_name , section_name , key , value )''' - écrit les données dans le fichier INI spécifié

Exemple :
external.m2_writeIni(%max_security_id, 'ViewPage', 'test.ini', 'Config', 'height', '100px');

14. '''max_modelessDialog( security_id , url , option , attr , window )''' - retourne une page de dialogue Web modale

Exemple :
var oDialog= external.max_modelessDialog( %max_security_id , 'blank.html', window , '', window );
var oDoc=oDialog.document;
oDoc.write('Testing');
oDoc.close();

15. '''max_activex(security_id ,program_id)''' - retourne l'objet ActiveX spécifié

Exemple :
var oWSH=external.max_activex(%max_security_id, 'WScript.Shell');
oWSH.run('notepad.exe');

16. '''m2_search_text(security_id)''' - retourne le texte de la barre d'adresses

Exemple :
alert(m2_search_text(%max_security_id));

17. '''max_callback(event_name)''' - une fonction qui est exécutée lorsque certains évênements de Maxthon se produisent (pour les Plugins HTML de type Button et les Plugins Script de type Sidebar)

Les Plugins HTML de type Button et les Plugins Script de type Sidebar peuvent utiliser la fonction max_callback pour réagir à certains évênements de Maxthon comme le changement d'onglet.

Exemple :
function max_callback(x){
if(x=='tab_change') alert('L'onglet en cours à changé.');
}

En testant le paramètre de la fonction max_callback, le Plugin peut récupérer les évênements suivants :

'''Plugins HTML de type Button'''

'''tab_change''' – après que l'onglet en cours soit changé

'''document_Complete''' - après que l'onglet en cours soit entièrement chargé

'''self_destroy''' - lorsque le html est déchargé, normalement lorsque Maxthon est fermé

'''Plugins Script de type Sidebar'''

'''sidebar_tab_change''' - après que l'onglet en cours soit changé

'''sidebar_activate''' - lorsque le Plugin Sidebar est activé

'''sidebar_deactivate''' - lorsque le Plugin Sidebar est désactivé

'''sidebar_unload''' - lorsque le Plugin Sidebar est déchargé (Maxthon est fermé)

18. '''max_getObj''' (pour Maxthon 2.0 seulement) - retourne plusieurs objets de Maxthon :

'''Info''' - information générale sur Maxthon

'''Adhunter''' – à propos du tueur de pubs

'''FavManager''' – à propos des Favoris

'''RssManager''' – à propos des flux RSS

'''PluginManager''' - à propos des Plugins, pour Maxthon 2.0.5 ou supérieur

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');

'''L'objet Info supporte les propriétés et mêthodes suivante :'''

Propriétés :

'''fileProxy''' - en lecture seul, retourne le chemin du document de configuration du Proxy utilisateur en cours.

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo.fileProxy);

'''folderUser''' - en lecture seul, retourne le chemin du dossier du profil de l'utilisateur en cours

Example :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo. folderUser);

Mêthodes :

'''getFolderPluginData(plugin_name)''' - obtient le chemin du dossier de stockage des données d'un Plugin pour l'utilisateur en cours et le Plugin indiqué

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo.getFolderPluginData('ViewSource!'));

'''L'object AdHunter supporte les mêthodes suivantes :'''

Méthodes :

'''reloadFilter(filter_name)''' – recharge le filtre de Maxthon spécifié (actuellement seulement les filtres de contenu) après avoir modifié le filtre en question

Exemple :
var oAdHunter=external.max_getObj(%max_security_id, 'AdHunter');
oAdHunter.reloadFilter('content');

'''enableFilter(filter_name, bEnable)''' – active ou désactive le filtre de 'contenu' ou de 'Popup' de Maxthon

Exemple :
var oAdHunter=external.max_getObj(%max_security_id, 'AdHunter');
oAdHunter.enableFilter ('content', false);

'''L'objet PluginManager supporte les mêthode suivantes :'''

'''getPluginFolder''' - retourne le chemin du dossier principal du Plugin de Maxthon

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getPluginFolder)

'''getCount''' - retourne le nombre de tous les Plugins installés, qu'ils soient activés ou désactivés

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getCount)

'''getList''' - retourne une liste qui contient des informations comme le nom, l'auteur, etc de tous les Plugins

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getList)

'''getPlugin(Index)''' - Index est un nombre, retourne les objets du Plugin correspondant

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
var oPlugin=oPluginManager.getPlugin(0);

'''L'objet Plugin retourné de getPlugin(Index) supporte les propriétés et mêthodes suivantes :'''

Propriétés :

'''title''' - lecture seule, retourne le nom du Plugin

Exemple :
alert(oPlugin.title);

'''folderName''' - lecture seule, retourne le nom du dossier du Plugin

Exemple :
alert(oPlugin.folderName);

'''fullPath''' - lecture seule, retourne le chemin complet du dossier du Plugin

Exemple :
alert(oPlugin.fullPath);

'''enable''' - lecture/écriture, retourne ou défini si le Plugin est actif

Exemple :
oPlugin.enable=false;
alert(oPlugin.enable);
oPlugin.enable=true;
alert(oPlugin.enable);

'''startAfterPageDone''' - lecture/écriture, retourne ou défini si le Plugin est en démarrage automatique

Exemple :
oPlugin.startAfterPageDone = true;
alert(oPlugin.startAfterPageDone);
oPlugin.startAfterPageDone = false;
alert(oPlugin.startAfterPageDone);

'''startAfterPageDoneUrl''' - lecture/écriture, retourne ou défini l'adresse où le Plugin sera démarré automatiquement

Exemple :
oPlugin.startAfterPageDoneUrl='*maxthon.com*|*maxthon.cn*';
alert(oPlugin.startAfterPageDoneUrl);

Mêthodes :

'''config()''' - ouvre la boîte de dialogue de configuration du Plugin (config.html)

Exemple :
oPlugin.config();

'''remove()''' - supprime le Plugin

Exemple :
oPlugin.remove();

== Mscript ==

Maxthon 2.0 supporte des mscript personnalisés en plus des scripts pour les Plugins de type Button. Contrairement au script normaux, les mscript ne sont pas exécutés sur des pages Web et aisni les mscript ne sont pas sujet aux restrictions de sécurité imposées au scripts normaux, et on ne doit pas craindre qu'ils soient exploités par des pages Web. Les mscript peuvent grandement améliorer les fonctionnalités des Plugins depuis que les mscript peuvent fonctionner avec les scripts désactivés et les mscript peuvent accéder aux contenus des frames à travers les domaines. Pour utiliser mscript dans un Plugin de type Button, remplacez la balise <script...> par <mscript...>

Exemple - le Plugin de type Button peut désactiver les script dans la page en cours en modifiant le contrôle de contenu de Maxthon :

<script language="javascript">
external.m2_run_cmd(%max_security_id, 33175);
</script>

Mais après que les scripts soient désactivés, le Plugin ne peut plus fonctionner. Ainsi il ne pourra plus réactiver les scripts dans la pages en cours. D'autre part, le Plugin mscript suivant peut fonctionner avec les scripts désactivés, ainsi il pourra réactiver les scripts dans la page en cours.

<mscript language="javascript">
external.m2_run_cmd(0, 33175);
</script>

Notez qu'un nombre arbitraire peut être utilisé comme %max_security_id lorsque le mscript est utilisé.

<center>[[Base de connaissances de Maxthon 2.0]]</center>

Les scripts de Maxthon v2.0

2008-10-02T12:41:26Z

Ray1 : /* '''Types de Plugin de Maxthon''' */

== '''Types de Plugin de Maxthon''' ==

Le type de Plugin de Maxthon est défini par ModuleType (Script, HTML, COM et EXE) et Type (Button, Sidebar, Toolbar, COM_Button, MHO, MHO_Button) simultanément :

Button SideBar Toolbar COM_Button MHO MHO_Button
Script oui oui
HTML oui
EXE oui
COM oui oui oui oui oui oui
COM_Global oui oui oui oui

==== '''1. ModuleType - Script, HTML, EXE, COM et COM_Global''' ====

'''Script''' - Le Plugin Script peut être de type button, qui exécute un script lorsqu'il est cliqué. le script peut être dans un langage supporté par IE, comme le javascript ou le vbscript. Maxthon 2.0 supporte le mscript qui exécute l'environment (plus de détails ci-après). Le Script peut également être de type sidebar, qui affiche un fichier HTML dans la barre latérale.

'''HTML''' - Un nouveau type de Plugin pour Maxthon 2.0 seulement. Le Plugin de type HTML est similaire au Plugin Script Sidebar dans sa nature. La différence majeure est que le Plugin Script Sidebar est affiché dans la barre latérale de Maxthon alors que le Plugin HTML est affiché comme un bouton dans la barre des Plugins ou n'importe quelle barre d'outils (barre d'état, barre des menus, barre des onglets, barre d'adresses...).

'''EXE''' - Le Plugin EXE sera affiché comme un bouton sur la barre des Plugins. Le Plugin EXE peut être n'importe quel fichier exécutable. Maxthon peut passer plusieurs paramètres au fichier exécutable comme l'url de la page Web en cours ou le "handle" de la fenêtre de Maxthon.

'''COM''' - Le Plugin COM peut être écrit en n'importe quel langage de programmation supporté par MSCOM, comme C++, Delphi, Visual Basic, C# etc. Les Plugins COM sont créés par onglet lors de la création d'un onglet (Types SideBar/Toolbar/MHO/COM_Button) ou lorsque le bouton du Plugin est cliqué (Type Button), et est détruit lorsque l'onglet est fermé. Un Plugin COM peut implémenter l'interface IObjectWithSite pour obtenir le pointeur "webbrowser" de l'onglet, l'événement du navigateur et le Document Object Model pour le manipuler.

'''COM_Global''' - Les Plugins COM_Global sont crées seulement une fois au démarrage de Maxthon, et sont détruits à la fermeture de Maxthon. Les Plugins COM_Global sont souvent pour les fonctions de navigation qui ne sont pas en relation avec le Document Object Model. Ainsi les Plugins COM_Global peuvent implémenter une fonction PutMaxCommander à travers l'interface IDispatch pour obtenir un objet du Plugin de Maxthon, qui peut être utilisé de la même façon qu'un objet externe de Maxthon pour les Plugins script (cf. les commandes ci-dessous des Plugins script), pour interagir avec le Document Object Model des onglets et Maxthon.

Notez que Maxthon 2.0 est "multithread" (un "thread" pour chaque onglet). Les Plugins développés pour une interaction approfondie avec le Document Object Model des onglets doivent être développés en COM (par onglet) au lieu de COM_Global ainsi ils pourront fonctionner plus efficacement avec le même "thread" d'un onglet individuel.

==== '''2. Type - Button, SideBar, Toolbar, COM_Button, MHO, and MHO_Button''' ====

'''Button''' - Un bouton sera ajouté sur la barre des Plugins. L'opération spécifiée par le script (Plugin Script), l'exécutable (Plugin EXE), la DLL (Plugin COM) sera exécutés lorsque le bouton sera cliqué. Optionnellement, Les Plugins de bouton peuvent implémenter un menu déroulant pour le Plugin. Un Plugin de bouton COM doit implémenter l'interface IOleCommandTarget pour recevoir le clic du bouton. Si un menu est implémenté, la fonction IOleCommandTarget_Exec recevra un id de commande de 1 lorsque le bouton est cliqué, et un id de commande de 2 lorsque le premier menu est cliqué, etc. Un Plugin de bouton COM est crée lorsque le bouton est cliqué et est détruit lorsque l'onglet est fermé (comme IE7).

'''SideBar''' - Un bouton sera ajouté à la barre latérale, et un élément sera ajouté au menu principal > Affichage > Barre latérale. Lorsque le bouton ou l’élément du menu est cliqué, La barre latérale de Maxthon s'ouvrira et affichera le fichier HTML spécifié par le Plugin (Plugin script), ou la fenêtre spécifiée par le Plugin à travers l'interface IDeskBand (Plugin com ou com_global).

'''Toolbar''' - Les Plugins de barre d'outils doivent être écris en COM. Un nouvelle barre d'outils sera ajoutée, qui pourra être affichée ou cachée à partir du menu principal > Affichage > Barre d'outils. Un Plugin de barre d'outils doit implémenter l'interface IDeskBand pour spécifier la fenêtre de la barre d'outils. Les Plugins de barre d'outils peuvent être COM ou COM_Global. Les Plugin de barre d'outils COM sont crées par onglet lorsque l'onglet est crée, et sont détruit lorsque l'onglet est fermé. Cela permet l'adoption de certaine barre d'outils d'IE dans Maxthon avec le minimum ou aucun changement. Les barres d'outils COM_Global sont crées seulement au démarrage de Maxthon, et sont détruis à la fermeture de Maxthon. Si une barre d'outils COM_Global implémente l'interface IObjectWithSite, elle peut obtenir le pointeur sur webbrowser de l'onglet actif à travers SetSite. Lorsque l'onglet actif est modifié, SetSite sera appelé de nouveau pour passer le pointeur sur webbrowser du nouvel onglet actif.

'''COM_Button''' - Les Plugins COM_Button sont identiques au Plugins de barre d'outils, à l'exception près que les Plugins COM_Button sont affichés dans Maxthon comme un bouton, et non pas comme une barre d'outils. Un Plugin COM_Button a la flexibilité de positionnement dans l'interface de Maxthon comme les autres boutons, mais il supporte également l'amélioration de l'interface d'une barre d'outils par rapport à un bouton.

'''MHO''' - Un Plugin MHO est identique au Browser Helper Object d'IE et doit être écrit en COM. Les Plugins MHO sont crées par onglet lorsque l'onglet est crée, et sont détruit lorsque l'onglet est fermé. Les Plugins MHO doivent implémenter l'interface IObjectWithSite pour obtenir un pointeur sur webbrowser de l'onglet pour interagir avec le DOM. Les Plugins MHO n'ont pas d'interface.

'''MHO_Button''' - Le Plugin MHO est une combinaison d'un Plugin MHO et d'un Plugin bouton COM. Les Plugins MHO_Button sont crées par onglet lorsque l'onglet est crée, et sont détruit lorsque l'onglet est fermé. En plus, une instance de Plugin MHO_Button sera crée lorsque son bouton est cliqué, et l'instance Sera détruite lorsque l'opération est terminée. Le Plugin MHO_Button ajoute essentiellement une interface bouton au Plugin MHO.

== Créer un Plugin pour Maxthon ==

'''Composants majeurs dun Plugin de Maxthon'''

Un Plugin de Maxthon contient généralement les fichiers suivants :

'''Fichiers INI''' – Le fichier plugin.ini est nécessaire pour tous les Plugins de Maxthon. Il définit plusieurs attributs du Plugin.

'''Fichiers HTML/DLL/EXE file''' – Le composant principal nécessaire à tous les Plugins de Maxthon spécifiant l'operation à réaliser ou le contenu à afficher.

'''Fichier Icônes''' – L'icône du bouton (*.ICO) nécessaire aux Plugins bouton et barre latérale. Le Plugin COM et EXE peut avoir besoins d'icônes dans ces propres ressources.

'''Config.html''' – Un fichier HTML optionnel pour être utilisé avec les Plugins de type Script et HTML comme boîte de dialogue de configuration.

'''Fichier plugin.ini'''

[General] nécessaire à la définition de plusieurs attributs du plugin

'''Name'''= nom du Plugin

'''Author'''= nom de l'auteur

'''Version'''= Version du Plugin

'''ModuleType'''= Peut être Script, HTML, EXE, COM, or COM_Global

'''FileName'''= Peut être un fichier HTML (Plugins Script et HTML), un fichier DLL (Plugins COM) ou un fichier EXE (Plugins EXE)

'''Comments'''= La description affichée dans les options du Plugin et/ou l'info-bulle du Plugin de type Button

'''Type'''= Peut être M2Plugin_Button, M2Plugin_Sidebar, M2Plugin_Toolbar, M2Plugin_COM_Button, M2Plugin_MHO, ou M2Plugin_MHO_Button

'''IdealSize'''= La largeur et la hauteur de l'interface du Plugin (ex. 120 20, pour un Plugin HTML seulement)

'''IdealSizeVertical'''= La largeur et la hauteur de l'interface du Plugin lorsqu'il est eancré verticalement (ex 120 20, optionnel pour un Plugin HTML)

'''Icon'''= L'icône du bouton pour les Plugins de type Button ou Sidebar

'''HotIcon'''= L'icône du bouton lorsque le bouton du Plugin est survolé

'''CLSID'''= Le CSLID pour les Plugins de type COM et COM_Global

'''DefaultLocation'''= Optionnel, défini la localisation par défaut de l'icône du Plugin, peut être '''None''' (dans la barre des Plugins mais non affichée après l'installation, l'utilisateur peut afficher le bouton à partir du menu Afficher ou masquer des boutons), '''MenuBar''', '''ToolBar''', ou '''StatusBar'''. Si il n'est pas défini, le Plugin sera affiché dans la barre des Plugins. Pour le Plugin de type '''Button''' et pour Maxthon 2.0.5 ou supérieur.

'''StartAfterPageDoneURL'''= Optionnel, défini les adresses où le Plugin doit démarrer automatiquement, supporte les caractères jocker, et on peut utiliser "|" pour séparer les adresses, ex. '''*maxthon.com*|forum.maxthon.cn*'''. Si il n'est pas défini, le Plugin démarrera pour toutes les adresses, équivalent à '''*'''. Pour les Plugins de types '''Script''' et '''Button''' et pour Maxthon 2.0.5 ou supérieur.

'''StartAfterPageDoneURLExclude'''= Optionnel, défini où le Plugin ne doit pas démarrer automatiquement, a une priorité supérieure à startAfterPageDoneUrl. Utilise le même format que startAfterPageDoneUrl ex. '''forum.maxthon.cn/index.php?|*.maxthon.cn/index.php?showtopic*'''. Pour les Plugins de types '''Script''' et '''Button''' et pour Maxthon 2.0.5 ou supérieur.

[MyIE2Buttons] Optionnel pour définir le menu déroulant pour les Plugins de types Button et MHO_Button

'''Count'''= Le nombre d'éléments du menu déroulant

'''Name1'''= Le nom du 1er élément du menu déroulant

'''FileName1'''= Le nom du fichier, ou le nom du fichier + les paramètres pour les Plugins de type EXE, du 1er élément du menu déroulant. Pour les Plugins de type COM Button et COM MHO_Button, mettre un nom arbitraire et distinct, ex. 1 pour FileName1 et 2 pour FileName2 etc

'''Installation d'un Plugin de Maxthon'''

Les Plugins de Maxthon sont installés dans le répertoire "Plugin" du dossier d'installation de Maxthon. Chaque Plugin possède son propre dossier dédié qui contient le fichier plugin.ini et les autres fichiers nécessaires et/ou sous-dossiers.

Un Plugin terminé, comprenant le dossier du Plugin et tous les fichiers et/ou sous-dossiers peut être compressé dans un fichier ZIP (*.zip) pour être distribué.

'''Maxthon 2.0'''

Maxthon 2.0 supporte un pack d'installation M2P de plugins (essentiellement un *.zip renommé en *.m2p. Le Plugin sera installé lorsque le fichier M2P est double cliqué ou glissé/déplacé dans la fenêtre de Maxthon.

'''Maxthon 1.X'''

Les Plugins sont installés dans Maxthon 1.x en suivant cette procédure :

1. Fermer Maxthon

2. Extraire le fichier zip du Plugin dans le dossier "Plugin" du répertoire d'installation de Maxthon. En général, le fichier plugin.ini devrait se trouver dans C:\Program Files\Maxthon\Plugin\NewPlugin\plugin.ini

3. Ouvrir Maxthon, la fenêtre d'installation du Plugin devrait s'afficher

4. Confirmer l'installation du nouveau plugin

== Commandes des Plugins Script de Maxthon ==

Maxthon propose plusieurs commandes pour améliorer la capacités des Plugins Script. Ces commandes peuvent être exécutées par l'intermédiaire de l'objet window.external. Certaines commandes nécessite un ID de sécurité généré au démarrage de Maxthon.

'''Comment obtenir l'ID de sécurité'''

1. Les Plugins Script de type Button penvent utiliser "%max_security_id" pour l'ID sécurité

2. Les Plugins Script de type Sidebar et les Plugins HTML de type Button doivent charger "max.src", un script généré par Maxthon. Ensuite "max_security_id" peut être utilisé :

<script src=max.src></script>

'''Référence des commandes des Plugins de Maxthon'''

Sauf indication contraire, les commandes suivantes sont applicables pour Maxthon 2.0 et Maxthon 1.X :

1. '''max_version''' - retourne le numéro de version de Maxthon

Exemple :
alert(external.max_version);

2. '''max_language_id''' - retourne l'ID de langue de Maxthon

Exemple :
alert(external.max_language_id);

Note : Maxthon 2.0 et Maxthon 1.X ont un format d'ID de langue différent

3. '''tab_count''' - retourne le nombre d'onglets ouvert dans Maxthon

Exemple :
alert(external.tab_count);

4. '''cur_sel''' - retourne l'index de l'onglet en cours de Maxthon

Exemple :
alert(external.cur_sel);

5. '''m2_plugin_folder( security_id , plugin_name )''' - retourne le chemin du dossier du Plugin spécifié

Exemple :
alert(external.m2_plugin_folder( %max_security_id , 'ViewSource!'));

6. '''m2_run_cmd( security_id , command_id )''' - exécute l'ID de la commande spécifiée

Exemple :
external. m2_run_cmd( %max_security_id , 32772 ));

Note: Maxthon 2.0 et Maxthon 1.X ont des ID de commande différent. Les ID des commandes se trouvent dans le fichier langue de Maxthon.

7. '''get_tab( security_id , tab_index )''' - retourne l'objet Window de l'onglet spécifié

Exemple :
var oWin=external.get_tab(%max_security_id, 0);
alert(oWin.document.URL);

8. '''activate_tab( security_id , tab_index )''' - active l'onglet spécifié

Exemple :
external.activate_tab(%max_security_id, 0);

9. '''close_tab( security_id , tab_index )''' - ferme l'onglet spécifié

Exemple :
external.close_tab(%max_security_id, 0);

10. '''readFile( security_id, plugin_name, file_name)''' - lit le contenu du fichier texte spécifié

Example :
var sText=external.readFile(%max_security_id, 'ViewPage', 'readme.txt');
alert(sText);

11. '''writeFile( security_id, plugin_name, file_name, content )''' - écrit le contenu dans le fichier texte spécifié

Exemple :
external.writeFile(%max_security_id, 'ViewPage', 'test.txt', 'Ceci est le contenu du fichier');

12. '''m2_readIni( security_id, plugin_name , file_name , section_name , key , default_value)''' - lit les données du fichier INI spécifié

Exemple :
var sDownloadTool=external.m2_readIni(%max_security_id, 'ViewPage', 'plugin.ini', 'Settings', 'Tool', '');
alert(sDownloadTool);

13. '''m2_writeIni( security_id , plugin_name , file_name , section_name , key , value )''' - écrit les données dans le fichier INI spécifié

Exemple :
external.m2_writeIni(%max_security_id, 'ViewPage', 'test.ini', 'Config', 'height', '100px');

14. '''max_modelessDialog( security_id , url , option , attr , window )''' - retourne une page de dialogue Web modale

Exemple :
var oDialog= external.max_modelessDialog( %max_security_id , 'blank.html', window , '', window );
var oDoc=oDialog.document;
oDoc.write('Testing');
oDoc.close();

15. '''max_activex(security_id ,program_id)''' - retourne l'objet ActiveX spécifié

Exemple :
var oWSH=external.max_activex(%max_security_id, 'WScript.Shell');
oWSH.run('notepad.exe');

16. '''m2_search_text(security_id)''' - retourne le texte de la barre d'adresses

Exemple :
alert(m2_search_text(%max_security_id));

17. '''max_callback(event_name)''' - une fonction qui est exécutée lorsque certains évênements de Maxthon se produisent (pour les Plugins HTML de type Button et les Plugins Script de type Sidebar)

Les Plugins HTML de type Button et les Plugins Script de type Sidebar peuvent utiliser la fonction max_callback pour réagir à certains évênements de Maxthon comme le changement d'onglet.

Exemple :
function max_callback(x){
if(x=='tab_change') alert('L'onglet en cours à changé.');
}

En testant le paramètre de la fonction max_callback, le Plugin peut récupérer les évênements suivants :

'''Plugins HTML de type Button'''

'''tab_change''' – après que l'onglet en cours soit changé

'''document_Complete''' - après que l'onglet en cours soit entièrement chargé

'''self_destroy''' - lorsque le html est déchargé, normalement lorsque Maxthon est fermé

'''Plugins Script de type Sidebar'''

'''sidebar_tab_change''' - après que l'onglet en cours soit changé

'''sidebar_activate''' - lorsque le Plugin Sidebar est activé

'''sidebar_deactivate''' - lorsque le Plugin Sidebar est désactivé

'''sidebar_unload''' - lorsque le Plugin Sidebar est déchargé (Maxthon est fermé)

18. '''max_getObj''' (pour Maxthon 2.0 seulement) - retourne plusieurs objets de Maxthon :

'''Info''' - information générale sur Maxthon

'''Adhunter''' – à propos du tueur de pubs

'''FavManager''' – à propos des Favoris

'''RssManager''' – à propos des flux RSS

'''PluginManager''' - à propos des Plugins, pour Maxthon 2.0.5 ou supérieur

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');

'''L'objet Info supporte les propriétés et mêthodes suivante :'''

Propriétés :

'''fileProxy''' - en lecture seul, retourne le chemin du document de configuration du Proxy utilisateur en cours.

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo.fileProxy);

'''folderUser''' - en lecture seul, retourne le chemin du dossier du profil de l'utilisateur en cours

Example :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo. folderUser);

Mêthodes :

'''getFolderPluginData(plugin_name)''' - obtient le chemin du dossier de stockage des données d'un Plugin pour l'utilisateur en cours et le Plugin indiqué

Exemple :
var oInfo=external.max_getObj(%max_security_id, 'info');
alert(oInfo.getFolderPluginData('ViewSource!'));

'''L'object AdHunter supporte les mêthodes suivantes :'''

Méthodes :

'''reloadFilter(filter_name)''' – recharge le filtre de Maxthon spécifié (actuellement seulement les filtres de contenu) après avoir modifié le filtre en question

Exemple :
var oAdHunter=external.max_getObj(%max_security_id, 'AdHunter');
oAdHunter.reloadFilter('content');

'''enableFilter(filter_name, bEnable)''' – active ou désactive le filtre de 'contenu' ou de 'Popup' de Maxthon

Exemple :
var oAdHunter=external.max_getObj(%max_security_id, 'AdHunter');
oAdHunter.enableFilter ('content', false);

'''L'objet PluginManager supporte les mêthode suivantes :'''

'''getPluginFolder''' - retourne le chemin du dossier principal du Plugin de Maxthon

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getPluginFolder)

'''getCount''' - retourne le nombre de tous les Plugins installés, qu'ils soient activés ou désactivés

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getCount)

'''getList''' - retourne une liste qui contient des informations comme le nom, l'auteur, etc de tous les Plugins

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
alert(oPluginManager.getList)

'''getPlugin(Index)''' - Index est un nombre, retourne les objets du Plugin correspondant

Exemple :
var oPluginManager=external.max_getObj(%max_security_id, 'PluginManager');
var oPlugin=oPluginManager.getPlugin(0);

'''L'objet Plugin retourné de getPlugin(Index) supporte les propriétés et mêthodes suivantes :'''

Propriétés :

'''title''' - lecture seule, retourne le nom du Plugin

Exemple :
alert(oPlugin.title);

'''folderName''' - lecture seule, retourne le nom du dossier du Plugin

Exemple :
alert(oPlugin.folderName);

'''fullPath''' - lecture seule, retourne le chemin complet du dossier du Plugin

Exemple :
alert(oPlugin.fullPath);

'''enable''' - lecture/écriture, retourne ou défini si le Plugin est actif

Exemple :
oPlugin.enable=false;
alert(oPlugin.enable);
oPlugin.enable=true;
alert(oPlugin.enable);

'''startAfterPageDone''' - lecture/écriture, retourne ou défini si le Plugin est en démarrage automatique

Exemple :
oPlugin.startAfterPageDone = true;
alert(oPlugin.startAfterPageDone);
oPlugin.startAfterPageDone = false;
alert(oPlugin.startAfterPageDone);

'''startAfterPageDoneUrl''' - lecture/écriture, retourne ou défini l'adresse où le Plugin sera démarré automatiquement

Exemple :
oPlugin.startAfterPageDoneUrl='*maxthon.com*|*maxthon.cn*';
alert(oPlugin.startAfterPageDoneUrl);

Mêthodes :

'''config()''' - ouvre la boîte de dialogue de configuration du Plugin (config.html)

Exemple :
oPlugin.config();

'''remove()''' - supprime le Plugin

Exemple :
oPlugin.remove();

== Mscript ==

Maxthon 2.0 supporte des mscript personnalisés en plus des scripts pour les Plugins de type Button. Contrairement au script normaux, les mscript ne sont pas exécutés sur des pages Web et aisni les mscript ne sont pas sujet aux restrictions de sécurité imposées au scripts normaux, et on ne doit pas craindre qu'ils soient exploités par des pages Web. Les mscript peuvent grandement améliorer les fonctionnalités des Plugins depuis que les mscript peuvent fonctionner avec les scripts désactivés et les mscript peuvent accéder aux contenus des frames à travers les domaines. Pour utiliser mscript dans un Plugin de type Button, remplacez la balise <script...> par <mscript...>

Exemple - le Plugin de type Button peut désactiver les script dans la page en cours en modifiant le contrôle de contenu de Maxthon :

<script language="javascript">
external.m2_run_cmd(%max_security_id, 33175);
</script>

Mais après que les scripts soient désactivés, le Plugin ne peut plus fonctionner. Ainsi il ne pourra plus réactiver les scripts dans la pages en cours. D'autre part, le Plugin mscript suivant peut fonctionner avec les scripts désactivés, ainsi il pourra réactiver les scripts dans la page en cours.

<mscript language="javascript">
external.m2_run_cmd(0, 33175);
</script>

Notez qu'un nombre arbitraire peut être utilisé comme %max_security_id lorsque le mscript est utilisé.

<center>[[Base de connaissances de Maxthon 2.0]]</center>

Détail des fichiers

2008-08-20T16:14:42Z

Ray1 :

Les fichiers et les répertoires qui composent cette nouvelle version sont très différents de la v1.x.

'''1. Répertoire racine de Maxthon :'''

*'''changelog.txt''' est un fichier texte qui contient les changements de Maxthon.

*'''enablelog.reg''' est un fichier à exécuter pour pouvoir créer le fichier Temp\log.txt de mise au point de Maxthon.

*'''License.txt''' est le fichier texte de la licence de Maxthon.

*'''Maxthon.exe''' est le programme principal.

*'''MaxthonUINST.exe''' est le programme de désinstallation de Maxthon.

*'''maxupadate.exe''' est un fichier exécutable qui permet de réaliser une mise à jour de Maxthon 2 : téléchargement, installation et relance de Maxthon.

*'''maxzlib.dll''' est la librairie zlib de compression de données.

*'''mxdb.dll''' est la librairie des bases de données de Maxthon, utilisée pour l'accélérateur de sites Web par exemple.

*'''MxExt.dll''' est la librairie des extensions de Maxthon ?

*'''MxFav.dll''' est la librairie des Favoris de Maxthon.

*'''mxpp.dll''' est une librairie de Maxthon qui ???.

*'''MxProxy2.dll''' est la librairie des Proxy de Maxthon.

*'''MxSk.dll''' est la librairie des Skins de Maxthon.

*'''mxtool.dll''' est la librairie des outils de Maxthon.

*'''MxUI.dll''' est la librairie de l'interface utilisateur de Maxthon.

*'''sp2enable.reg''' est le fichier à exécuter pour activer les réglages du SP2 pour IE.

*'''sp2disable.reg''' est le fichier à exécuter pour désactiver les réglages du SP2 pour IE.

'''2. Répertoire Config :'''

Le répertoire Config est créé après le 1er lancement de Maxthon et il contient les 2 fichiers suivants :

*'''ss.dat''' est un fichier crypté téléchargé à l'adresse http://gocn.maxthon.com/client/m2/xmllists/SS.TXT.

*'''Config.ini''' est un fichier crypté crée à la fermeture de Maxthon.

'''3. Répertoire Default :'''

Le répertoire '''Default''' contient les fichiers de configuration par défaut qui servent à créer les fichiers de configuration au 1er lancement de Maxthon.

*'''config\Config.ini''' est le fichier de configuration générale par défaut de Maxthon.

*'''config\dmgr.ini''' est un fichier crypté contenant la liste des téléchargeurs reconnus par Maxthon.

*'''config\IEP.txt''' est un fichier crypté téléchargé à l'adresse http://gocn.maxthon.com/CLiENT/M2/xMllISTS/IEp.txt.

*'''config\mxsafe.dat''' est un fichier crypté contenant la liste de confiance par défaut du gardien de Maxthon.

*'''config\Plugins.ini''' est un fichier contenant la liste des Plugins de Maxthon et s'ils sont actifs.

*'''config\ProxyConfig.xml''' est le fichier de configuration des Proxy par défaut de Maxthon.

*'''config\SiteList.xml''' est le fichier de configuration des listes noire/blanche par défaut des filtres de contenu.

*'''config\System.dat''' est un fichier crypté ???

*'''Filter\template.xml''' est le fichier de modèle par défaut pour créer un pack de filtres anglais.

*'''Filter\template0x0804.xml''' est le fichier de modèle par défaut pour créer un pack de filtres chinois.

'''4. Répertoire Favicons :'''

Le répertoire '''Favicons''' est créé au 1er lancement de Maxthon et contient les Favicons des sites visités.

'''5. Répertoire Filter :'''

Le répertoire '''Filter''' est vide par défaut. Il contient les fichiers des packs de filtres.

'''6. Répertoire Language :'''

Le répertoire '''Language''' contient des répertoires portant le nom des différentes langues et contient chacun un fichier '''language.ini''' de traduction de Maxthon.

'''7. Répertoire Modules :'''

Le répertoire '''Modules''' contient des répertoires qui contiennent les modules optionnels de Maxthon, sous forme de dll ou de fichiers exécutables.

*'''MxCapScr\MxCapScr.dll''' est la librairie de capture d'écran de Maxthon.

*'''MxDownloader\asyn_dns.dll''' est une librairie du Téléchargeur de Maxthon.

*'''MxDownloader\download_interface.dll''' est une librairie du Téléchargeur de Maxthon.

*'''MxDownloader\MxDownloadServer.exe''' est le fichier exécutable du Téléchargeur de Maxthon.

*'''MxDownloader\TaskManager.dll''' est une librairie du Téléchargeur de Maxthon.

*'''MxGuardian\MxGuardian.dll''' est la librairie du gardien de Maxthon.

*'''MxHistory\MxHistory.dll''' est la librairie de l'historique de Maxthon.

*'''MxPageSearch\MxPageSearch.dll''' est la librairie de recherche dans la page de Maxthon.

*'''MxSpellCheck\MxSpellCheck.dll''' est la librairie de vérification orthographique de Maxthon.

*'''MxSpellCheck\Dict\en_US.aff''' est le fichier affixe anglais de vérification orthographique de Maxthon.

*'''MxSpellCheck\Dict\en_US.dic''' est le fichier dictionnaire anglais de vérification orthographique de Maxthon.

*'''MxUpdate\MxUp.exe''' est le fichier exécutable de mise à jour de Maxthon.

*'''MxWebBoost\MxWebBoost.dll''' est la librairie de l'accélérateur des sites Web de Maxthon.

'''8. Répertoire Plugin :'''

Le répertoire '''Plugin''' contient le fichier Plugin SDK.url par défaut. Il contient les répertoires de chaque Plugin de Maxthon.

'''9. Répertoire SharedAccount :'''

Le répertoire '''SharedAccount''' est créé au 1er lancement de Maxthon si on choisit un compte commun local au démarrage. Sinon, il sera créé un répertoire portant le nom de l'adresse email si on choisit un compte personnel. Ces répertoires contiennent 4 répertoires par défaut :

:'''9.1 Répertoire Config :'''

:Le répertoire '''Config''' contient les fichiers de configuration du compte associé :

:*'''AdHunter.m1f''' est le fichier les exceptions/filtres du bloqueur de Popups de Maxthon.

:*'''Config.ini''' est le fichier de configuration générale de Maxthon crée à partir du fichier Default\Config\Config.ini.

:*'''Downloader.ini''' est le fichier de configuration du module de téléchargement de Maxthon.

:*'''Filter.ini''' est le fichier contenant la liste des packs de filtre de Maxthon.

:*'''MxCapScr.ini''' est le fichier de configuration du module de capture d'écran de Maxthon.

:*'''mxsafe.dat''' est un fichier crypté contenant la liste de confiance du gardien de Maxthon crée à partir du fichier Default\Config\mxsafe.dat.

:*'''PageSearch.ini''' est le fichier de configuration du module de recherche dans la page de Maxthon.

:*'''Plugins.ini''' est le fichier contenant la liste des Plugins de Maxthon crée à partir du fichier Default\Config\Plugins.ini.

:*'''ProxyConfig.xml''' est le fichier de configuration des Proxy de Maxthon crée à partir du fichier Default\Config\ProxyConfig.xml.

:*'''SiteList.xml''' est le fichier de configuration des listes noire/blanche de Maxthon crée à partir du fichier Default\Config\SiteList.xml.

:*'''spellcheck.ini''' est le fichier de configuration du module de vérification orthographique de Maxthon.

:*'''ui.xml''' est le fichier de configuration de l'interface graphique de Maxthon.

:'''9.2 Répertoire Data :'''

:Le répertoire '''Data''' contient les fichiers de données du compte associé :

:*'''Backup\mbookmark_aaaa_mm_jj.xml''' est un répertoire contenant la copie du fichier SharedAccount\Data\mbookmark.xml modifié le jj/mm/aaaa.

:*'''Collector.xml''' est un fichier contenant les données sauvegardées du Post-it de Maxthon.

:*'''Dynamic.ini''' est le fichier de configuration de la barre latérale de Maxthon.

:*'''FeedCache\xxxxxx.xml''' est le répertoire du cache des Flus RSS de Maxthon.

:*'''Form.dat''' est un fichier non crypté contenant les données du remplissage automatique des formulaires.
:-> Remarque : ce fichier est crypté dans le cas d'une connexion avec un compte Passport de Maxthon.

:*'''History.dat''' est l'ancien fichier de l'historique de navigation crypté faiblement (obsolète).

:*'''History2.dat''' est le nouveau fichier de l'historique de navigation crypté fortement.

:*'''LastSession.ini''' est un fichier contenant la liste des URL des onglets dernièrement fermés.

:*'''mbookmark.xml''' est le fichier des Favoris/Groupes/Flux RSS cryptés de Maxthon obtenu par importation des Favoris d'IE au 1er lancement de Maxthon.

:*'''TmpSession.ini''' est un fichier contenant la liste des URL des derniers onglets en cours.

:'''9.3 Répertoire Downloads :'''

:Le répertoire '''Downloads''' est un répertoire vide qui contient les données téléchargées par Maxthon.

:'''9.4 Répertoire PluginData :'''

:Le répertoire '''PluginData''' contient les répertoires contenant les réglages utilisateur des Plugins de Maxthon.

:'''9.5 Répertoire Session :'''

:Le répertoire '''Session''' est le répertoire de sauvegarde des sessions (fichier .mse) par défaut.

'''10. Répertoire Skin :'''

Le répertoire '''Skin''' contient le fichier Skin SDK.url par défaut. Il contient les répertoires de chaque Skin de Maxthon.

'''11. Répertoire Temp :'''

Le répertoire '''Temp''' est vide par défaut. Après le 1er démarrage de Maxthon, il récupère les fichiers suivants à l'adresse http://go.maxthon.com/client/m2/XMllisTS/ :

*'''AList.xml''' est le fichier des liens de traduction automatique des sites du menu '''Bouton Aller''' de la barre d'adresse.

*'''Default_Preview.jpg''' est l'image de prévisualisation du Skin par défaut.

*'''French_tips.ini''' est un fichier crypté contenant les astuces de Maxthon en anglais, car il n'existe pas de traduction pour l'instant.

*'''Loading.swf''' est l'animation Flash de l'onglet '''Mon compte''' de la barre latérale.

*'''log.txt''' est le fichier de traces pour la mise au point de Maxthon.

*'''NList.xml''' est le fichier des liens du menu '''Navigateur''' de la barre d'outils Web.

*'''PList.xml''' est le fichier des liens du menu '''Ajouter''' de la barre des Plugins.

*'''SList.xml''' est le fichier des liens des moteurs de recherche de la barre de recherche.

'''12. Répertoire Template :'''

Le répertoire '''Template''' contient les répertoires/fichiers nécessaires à l'affichage de certains écrans de Maxthon :

*'''_shared''' est un répertoire qui contient des fichiers communs.

*'''ConfigWizard''' est le répertoire qui contient les fichiers nécessaires à l'affichage de l'assistant de paramétrage de Maxthon.

*'''Download''' est le répertoire qui contient les fichiers nécessaires à l'affichage du téléchargeur de Maxthon.

*'''FeedView''' est le répertoire qui contient les fichiers nécessaires à l'affichage des flux RSS de Maxthon.

*'''History''' est le répertoire qui contient les fichiers nécessaires à l'affichage de l'historique de navigation de Maxthon.

*'''my2008''' est le répertoire qui contient les fichiers nécessaires à l'affichage de la nouvelle page de démarrage de Maxthon réalisée pour les JO 2008.

*'''Options''' est le répertoire qui contient les fichiers nécessaires à l'affichage du centre de configuration de Maxthon.

*'''ResumeSession''' est le répertoire qui contient les fichiers nécessaires à l'affichage de l'écran de réouverture des onglets de Maxthon.

{|align=center
| [[Personnalisation]] '''<'''
|
| '''>''' [[Maxthon 2.0]]
|}

Maxthon n'est pas IE

2008-08-02T10:14:05Z

Ray1 : /* '''Maxthon n’est pas Internet Explorer ! Tu piges ?''' */

='''Maxthon n’est pas Internet Explorer ! Tu piges ?'''=

[http://blog.maxthon.com/?author=263 MaxthonGuy], le 8 juillet 2008 à 11:50.

''Garrett Groff a laissé un commentaire dans un message précédent qui reflète beaucoup des propos que je lis au sujet de Maxthon. Garrett avait des doutes au sujet d'un article que j'avais écrit auparavant disant que Maxthon était beaucoup plus sûr qu'Internet Explorer et il souhaitait une explication, car comme tout le monde le sait, Maxthon est juste un I.E « déguisé ». Voici donc ma réponse à Garrett.''

Le seul composant majeur que Maxthon et Internet Explorer ont en commun est le moteur de rendu Trident, qui n'est pas un terrain fertile pour les malwares. La plupart des malwares qui attaquent Internet Explorer utilisent la technologie « browser helper object » (BHO) d'I.E, et Maxthon est configuré pour ne pas charger d’objet BHO d'IE. Cela signifie que tout malware qui essaye d'utiliser BHO pour faire son sale travail n'affecte pas Maxthon..

Outre l'utilisation des BHO, la plupart des voies par lesquels les malwares exploitent I.E se trouvent dans son interface utilisateur, qui est la couche applicative constituant les menus, les onglets, les barres d'outils, les barres latérales, etc. I.E a son interface utilisateur et Maxthon a sa propre interface utilisateur. Les logiciels malveillants programmés pour attaquer l'interface utilisateur d'I.E ne savent pas quoi faire en présence de l'interface utilisateur de Maxthon.

Un autre point. Les développeurs de Maxthon réagissent aux problèmes de sécurités bien plus rapidement que Microsoft. Par exemple pour l'exploit JPG de 2004, nos développeurs ont mis un patch à la disposition des utilisateurs de Maxthon plusieurs mois avant que Microsoft ne le fasse.

Je pense qu’une grande part de ces préoccupations au sujet de la sécurité est issue du mythe selon lequel Maxthon est juste un habillage pour embellir Internet Explorer. Et c’est tellement faux. Les fonctionnalités qui rendent Maxthon plus performant et le distingue des autres navigateurs sont toutes des créations originales de Maxthon – et non d'I.E.

Ces fonctionnalités incluent :

* La manière dont il gère les onglets.

* Sans doute les téléchargements les plus rapides du Web.

* Un navigateur configurable par l'utilisateur.

* Une recherche multi-moteurs.

* Le contrôle du contenu pour bloquer les publicités ou le contenu litigieux, et si vous le souhaitez, les images, les animations, les sons, et les contrôles ActiveX.

* Un écran fractionnable pour afficher 2 pages à la fois.

* La possibilité de « décoller » un onglet et de déplacer sa page où vous le souhaitez. (Vraiment génial si vous utilisez 2 moniteurs).

* Toutes les possibilités différentes de faire une capture d’écran complète ou partielle.

* La navigation et les commandes utilisant les mouvements de la souris, les alias d'URL et/ou les touches de fonctions programmables.

* Le Post-it - un bloc-notes où vous pouvez coller ou glisser et déplacer des morceaux de textes que vous souhaitez assembler.

* La possibilité de créer des groupes de pages Web que vous pouvez enregistrer, actualiser, et ouvrir comme des groupes.

* L'actualisation automatique des onglets ainsi que les possibilités de les verrouiller et de les renommer.

* Des traducteurs pour une douzaine de langues ou plus.

* Un détecteur de fichiers qui détecte et détermine automatiquement la véritable URL des fichiers comme les vidéos de YouTube.

* Une fonction de remplissage automatique des formulaires qui permet d'éviter les services payants de RoboForm.

* Des informations sur le propriétaire d'un domaine, sur le rang de tel ou tel site dans le classement d’audience Web Alexa, les versions archivées et les pages similaires.

* La possibilité d'éditer une page pour, par exemple, éliminer les publicités avant d'imprimer la page.

* Une recherche dans la page courante qui inclue un compteur de résultat de type 3/10, une mise en surbrillance de ces résultats, ainsi que des critères de recherche plus ou moins précis (allant du simple mot au cas plus détaillé).

* La recherche rapide d'un mot par glisser et déplacer.

* Un lecteur de flux RSS.

* L’affichage rapide des pages, car elles sont préchargées.

* Un économiseur de CPU pour laisser plus de ressources systèmes aux autres programmes.

* Une boîte de dialogue à la fermeture qui vous propose plusieurs choix quant aux pages à rouvrir lors du prochain redémarrage de Maxthon.

Maintenant, le truc c'est que, toutes ces fonctionnalités sont intégrées dans Maxthon. Vous n'avez pas à installer un tas de Plugins ou d'extensions pour avoir ces fonctionnalités. Toutefois Maxthon propose aussi des centaines de Plugins et de Skins pour le personnaliser encore plus si vous en avez envie.

Et si vous êtes submergés par toutes ces fonctions, vous pouvez éliminer toutes celles que vous ne voulez pas en quelques secondes.

''' * Si vous ne l'avez pas déjà fait, [http://www.maxthon-fr.com/site/download.htm essayez-le].'''

===='''Ne surfez pas seulement sur le Web. Emparez-vous-en !'''====

'''Source :''' http://blog.maxthon.com/?p=130

Maxthon n'est pas IE

2008-08-01T18:30:32Z

Ray1 : /* '''Maxthon n’est pas Internet Explorer ! Tu piges ?''' */

='''Maxthon n’est pas Internet Explorer ! Tu piges ?'''=

[http://blog.maxthon.com/?author=263 MaxthonGuy], le 8 juillet 2008 à 11:50.

''Garrett Groff a laissé un commentaire dans un message précédent qui reflète beaucoup des propos que je lis au sujet de Maxthon. Garrett avait des doutes au sujet d'un article que j'avais écrit auparavant disant que Maxthon était beaucoup plus sûr qu'Internet Explorer et il souhaitait une explication, car comme tout le monde le sait, Maxthon est juste un I.E « déguisé ». Voici donc ma réponse à Garrett.''

Le seul composant majeur que Maxthon et Internet Explorer ont en commun est le moteur de rendu Trident, qui n'est pas un terrain fertile pour les malwares. La plupart des malwares qui attaquent Internet Explorer utilisent la technologie « browser helper object » (BHO) d'I.E, et Maxthon est configuré pour ne pas charger d’objet BHO d'IE. Cela signifie que tout malware qui essaye d'utiliser BHO pour faire son sale travail n'affecte pas Maxthon..

Outre l'utilisation des BHO, la plupart des voies par lesquels les malwares exploitent I.E se trouvent dans son interface utilisateur, qui est la couche applicative constituant les menus, les onglets, les barres d'outils, les barres latérales, etc. I.E a son interface utilisateur et Maxthon a sa propre interface utilisateur. Les logiciels malveillants programmés pour attaquer l'interface utilisateur d'I.E ne savent pas quoi faire en présence de l'interface utilisateur de Maxthon.

Un autre point. Les développeurs de Maxthon réagissent aux problèmes de sécurités bien plus rapidement que Microsoft. Par exemple pour l'exploit JPG de 2004, nos développeurs ont mis un patch à la disposition des utilisateurs de Maxthon plusieurs mois avant que Microsoft ne le fasse.

Je pense qu’une grande part de ces préoccupations au sujet de la sécurité est issue du mythe selon lequel Maxthon est juste un habillage pour embellir Internet Explorer. Et c’est tellement faux. Les fonctionnalités qui rendent Maxthon plus performant et le distingue des autres navigateurs sont toutes des créations originales de Maxthon – et non d'I.E.

Ces fonctionnalités incluent :

* La manière dont il gère les onglets.

* Sans doute les téléchargements les plus rapides du Web.

* Un navigateur configurable par l'utilisateur.

* Une recherche multi-moteurs.

* Le contrôle du contenu pour bloquer les publicités ou le contenu litigieux, et si vous le souhaitez, les images, les animations, les sons, et les contrôles ActiveX.

* Un écran fractionnable pour afficher 2 pages à la fois.

* La possibilité de « décoller » un onglet et de déplacer sa page où vous le souhaitez. (Vraiment génial si vous utilisez 2 moniteurs).

* Toutes les possibilités différentes de faire une capture d’écran complète ou partielle.

* La navigation et les commandes utilisant les mouvements de la souris, les alias d'URL et/ou les touches de fonctions programmables.

* Le Post-it - un bloc-notes où vous pouvez coller ou glisser et déplacer des morceaux de textes que vous souhaitez assembler.

* La possibilité de créer des groupes de pages Web que vous pouvez enregistrer, actualiser, et ouvrir comme des groupes.

* L'actualisation automatique des onglets ainsi que les possibilités de les verrouiller et de les renommer.

* Des traducteurs pour une douzaine de langues ou plus.

* Un détecteur de fichiers qui détecte et détermine automatiquement la véritable URL des fichiers comme les vidéos de YouTube.

* Une fonction de remplissage automatique des formulaires qui permet d'éviter les services payants de RoboForm.

* Des informations sur le propriétaire d'un domaine, sur le rang de tel ou tel site dans le classement d’audience Web Alexa, les versions archivées et les pages similaires.

* La possibilité d'éditer une page pour, par exemple, éliminer les publicités avant d'imprimer la page.

* Une recherche dans la page courante qui inclue un compteur de résultat de type 3/10, une mise en surbrillance de ces résultats, ainsi que des critères de recherche plus ou moins précis (allant du simple mot au cas plus détaillé).

* La recherche rapide d'un mot par glisser et déplacer.

* Un lecteur de flux RSS.

* L’affichage rapide des pages, car elles sont préchargées.

* Un économiseur de CPU pour laisser plus de ressources systèmes aux autres programmes.

* Une boîte de dialogue à la fermeture qui vous propose plusieurs choix quant aux pages à rouvrir lors du prochain redémarrage de Maxthon.

Maintenant, le truc c'est que, toutes ces fonctionnalités sont intégrées dans Maxthon. Vous n'avez pas à installer un tas de Plugins ou d'extensions pour avoir ces fonctionnalités. Toutefois Maxthon propose aussi des centaines de Plugins et de Skins pour le personnaliser encore plus si vous en avez envie.

Et si vous êtes submergés par toutes ces fonctions, vous pouvez éliminer toutes celles que vous ne voulez pas en quelques secondes.

'''Si vous ne l'avez pas déjà fait, [http://www.maxthon-fr.com/site/download.htm essayez-le].'''

===='''Ne surfez pas seulement sur le Web. Emparez-vous-en !'''====

'''Source :''' http://blog.maxthon.com/?p=130

Maxthon n'est pas IE

2008-08-01T16:51:09Z

Ray1 : /* '''Maxthon n’est pas Internet Explorer ! Tu piges ?''' */

='''Maxthon n’est pas Internet Explorer ! Tu piges ?'''=

[http://blog.maxthon.com/?author=263 MaxthonGuy], le 8 juillet 2008 à 11:50.

''Garrett Groff a laissé un commentaire dans un message précédent qui reflète beaucoup des propos que je lis au sujet de Maxthon. Garrett avait des doutes au sujet d'un article que j'avais écrit auparavant disant que Maxthon était beaucoup plus sûr qu'Internet Explorer et il souhaitait une explication, car comme tout le monde le sait, Maxthon est juste un I.E « déguisé ». Voici donc ma réponse à Garrett.''

Le seul composant majeur que Maxthon et Internet Explorer ont en commun est le moteur de rendu Trident, qui n'est pas un terrain fertile pour les malwares. La plupart des malwares qui attaquent Internet Explorer utilisent la technologie « browser helper object » (BHO) d'I.E, et Maxthon est configuré pour ne pas charger d’objet BHO d'IE. Cela signifie que tout malware qui essaye d'utiliser BHO pour faire son sale travail n'affecte pas Maxthon..

Outre l'utilisation des BHO, la plupart des voies par lesquels les malwares exploitent I.E se trouvent dans son interface utilisateur, qui est la couche applicative constituant les menus, les onglets, les barres d'outils, les barres latérales, etc. I.E a son interface utilisateur et Maxthon a sa propre interface utilisateur. Les logiciels malveillants programmés pour attaquer l'interface utilisateur d'I.E ne savent pas quoi faire en présence de l'interface utilisateur de Maxthon.

Un autre point. Les développeurs de Maxthon réagissent aux problèmes de sécurités bien plus rapidement que Microsoft. Par exemple pour l'exploit JPG de 2004, nos développeurs ont mis un patch à la disposition des utilisateurs de Maxthon plusieurs mois avant que Microsoft ne le fasse.

Je pense qu’une grande part de ces préoccupations au sujet de la sécurité est issue du mythe selon lequel Maxthon est juste un habillage pour embellir Internet Explorer. Et c’est tellement faux. Les fonctionnalités qui rendent Maxthon plus performant et le distingue des autres navigateurs sont toutes des créations originales de Maxthon – et non d'I.E.

Ces fonctionnalités incluent :

* La manière dont il gère les onglets.

* Sans doute les téléchargements les plus rapides du Web.

* Un navigateur configurable par l'utilisateur.

* Une recherche multi-moteurs.

* Le contrôle du contenu pour bloquer les publicités ou le contenu litigieux, et si vous le souhaitez, les images, les animations, les sons, et les contrôles ActiveX.

* Un écran fractionnable pour afficher 2 pages à la fois.

* La possibilité de « décoller » un onglet et de déplacer sa page où vous le souhaitez. (Vraiment génial si vous utilisez 2 moniteurs).

* Toutes les possibilités différentes de faire une capture d’écran complète ou partielle.

* La navigation et les commandes utilisant les mouvements de la souris, les alias d'URL et/ou les touches de fonctions programmables.

* Le Post-it - un bloc-notes où vous pouvez coller ou glisser et déplacer des morceaux de textes que vous souhaitez assembler.

* La possibilité de créer des groupes de pages Web que vous pouvez enregistrer, actualiser, et ouvrir comme des groupes.

* L'actualisation automatique des onglets ainsi que les possibilités de les verrouiller et de les renommer.

* Des traducteurs pour une douzaine de langues ou plus.

* Un détecteur de fichiers qui détecte et détermine automatiquement la véritable URL des fichiers comme les vidéos de YouTube.

* Une fonction de remplissage automatique des formulaires qui permet d'éviter les services payants de RoboForm.

* Des informations sur le propriétaire d'un domaine, sur le rang de tel ou tel site dans le classement d’audience Web Alexa, les versions archivées et les pages similaires.

* La possibilité d'éditer une page pour, par exemple, éliminer les publicités avant d'imprimer la page.

* Une recherche dans la page courante qui inclue un compteur de résultat de type 3/10, une mise en surbrillance de ces résultats, ainsi que des critères de recherche plus ou moins précis (allant du simple mot au cas plus détaillé).

* La recherche rapide d'un mot par glisser et déplacer.

* Un lecteur de flux RSS.

* L’affichage rapide des pages, car elles sont préchargées.

* Un économiseur de CPU pour laisser plus de ressources systèmes aux autres programmes.

* Une boîte de dialogue à la fermeture qui vous propose plusieurs choix quant aux pages à rouvrir lors du prochain redémarrage de Maxthon.

Maintenant, le truc c'est que, toutes ces fonctionnalités sont intégrées dans Maxthon. Vous n'avez pas à installer un tas de Plugins ou d'extensions pour avoir ces fonctionnalités. Toutefois Maxthon propose aussi des centaines de Plugins et de Skins pour le personnaliser encore plus si vous en avez envie.

Et si vous êtes submergés par toutes ces fonctions, vous pouvez éliminer toutes celles que vous ne voulez pas en quelques secondes.

'''Si vous ne l'avez pas déjà fait, essayez-le.'''

===='''Ne surfez pas seulement sur le Web. Emparez-vous-en !'''====

'''Source :''' http://blog.maxthon.com/?p=130

Maxthon n'est pas IE

2008-08-01T13:59:33Z

Ray1 : /* '''Maxthon n’est pas Internet Explorer ! Tu piges ?''' */

='''Maxthon n’est pas Internet Explorer ! Tu piges ?'''=

[http://blog.maxthon.com/?author=263 MaxthonGuy], le 8 juillet 2008 à 11:50.

''Garrett Groff a laissé un commentaire dans un message précédent qui reflète beaucoup des propos que je lis au sujet de Maxthon. Garrett avait des doutes au sujet d'un article que j'avais écrit auparavant disant que Maxthon était beaucoup plus sûr qu'Internet Explorer et il souhaitait une explication, car comme tout le monde le sait, Maxthon est juste un I.E « déguisé ». Voici donc ma réponse à Garrett.''

Le seul composant majeur que Maxthon et Internet Explorer ont en commun est le moteur de rendu Trident, qui n'est pas un terrain fertile pour les malwares. La plupart des malwares qui attaquent Internet Explorer utilisent la technologie « browser helper object » (BHO) d'I.E, et Maxthon est configuré pour ne pas charger d’objet BHO d'IE. Cela signifie que tout malware qui essaye d'utiliser BHO pour faire son sale travail n'affecte pas Maxthon..

Outre l'utilisation des BHO, la plupart des voies par lesquels les malwares exploitent I.E se trouvent dans son interface utilisateur, qui est la couche applicative constituant les menus, les onglets, les barres d'outils, les barres latérales, etc. I.E a son interface utilisateur et Maxthon a sa propre interface utilisateur. Les logiciels malveillants programmés pour attaquer l'interface utilisateur d'I.E ne savent pas quoi faire en présence de l'interface utilisateur de Maxthon.

Un autre point. Les développeurs de Maxthon réagissent aux problèmes de sécurités bien plus rapidement que Microsoft. Par exemple pour l'exploit JPG de 2004, nos développeurs ont mis un patch à la disposition des utilisateurs de Maxthon plusieurs mois avant que Microsoft ne le fasse.

Je pense qu’une grande part de ces préoccupations au sujet de la sécurité est issue du mythe selon lequel Maxthon est juste un habillage pour embellir Internet Explorer. Et c’est tellement faux. Les fonctionnalités qui rendent Maxthon plus performant et le distingue des autres navigateurs sont toutes des créations originales de Maxthon – et non d'I.E.

Ces fonctionnalités incluent :

* La manière dont il gère les onglets.

* Sans doute les téléchargements les plus rapides du Web.

* Un navigateur configurable par l'utilisateur.

* Recherche multi-moteurs de recherche.

* Le contrôle du contenu pour bloquer les publicités ou le contenu litigieux, et si vous le souhaitez, les images, les animations, les sons, et les contrôles ActiveX.

* Un écran fractionnable pour afficher 2 pages à la fois.

* La possibilité de « décoller » un onglet et de déplacer sa page où vous le souhaitez. (Vraiment génial si vous utilisez 2 moniteurs).

* Toutes les possibilités différentes de faire une capture d’écran complète ou partielle.

* La navigation et les commandes utilisant les mouvements de la souris, les alias d'URL et/ou les touches de fonctions programmables.

* Le Post-it - un bloc-notes où vous pouvez coller ou glisser et déplacer des morceaux de textes que vous souhaitez assembler.

* La possibilité de créer des groupes de pages Web que vous pouvez enregistrer, actualiser, et ouvrir comme des groupes.

* L'actualisation automatique des onglets ainsi que les possibilités de les verrouiller et de les renommer.

* Des traducteurs pour une douzaine de langues ou plus

* Un détecteur de fichiers qui détecte et détermine automatiquement la véritable URL des fichiers comme les vidéos de YouTube.

* Une fonction de remplissage automatique des formulaires qui permet d'éviter les services payants de RoboForm.

* Des informations sur le propriétaire d'un domaine, sur le rang de tel ou tel site dans le classement d’audience Web Alexa, les versions archivées et les pages similaires.

* La possibilité d'éditer une page pour, par exemple, éliminer les publicités avant d'imprimer la page.

* Une recherche dans la page courante qui inclue un compteur de résultat de type 3/10, une mise en surbrillance de ces résultats, ainsi que des critères de recherche plus ou moins précis (allant du simple mot au cas plus détaillé).

* La recherche rapide d'un mot par glisser et déplacer.

* Un lecteur de flux RSS.

* L’affichage rapide des pages, car elles sont préchargées.

* Un économiseur de CPU pour laisser plus de ressources systèmes aux autres programmes.

* Une boîte de dialogue à la fermeture qui vous propose plusieurs choix quant aux pages à rouvrir lors du prochain redémarrage de Maxthon.

Maintenant, le truc c'est que, toutes ces fonctionnalités sont intégrées dans Maxthon. Vous n'avez pas à installer un tas de Plugins ou d'extensions pour avoir ces fonctionnalités. Toutefois Maxthon propose aussi des centaines de Plugins et de Skins pour le personnaliser encore plus si vous en avez envie.

Et si vous êtes submergés par toutes ces fonctions, vous pouvez éliminer toutes celles que vous ne voulez pas en quelques secondes.

'''Si vous ne l'avez pas déjà fait, essayez-le.'''

===='''Ne surfez pas seulement sur le Web. Emparez-vous-en !'''====

'''Source :''' http://blog.maxthon.com/?p=130

Tutorial Plugin : 4 - Astuces

2008-07-02T14:50:42Z

Ray1 :

__TOC__

Il est recommandé de mettre un plugin de barre d'outils à l'intérieur d'une fonction anonyme. Ainsi, vous serez certain de ne pas avoir de problème avec les variables et que les sites Web ne pourront pas utiliser vos fonctions et vos "security_id".

Une fonction anonyme ressemble à ceci :

<pre>
(funtion() {

//your code

}())
</pre>

L'exemple de fonction anonyme de la Partie 1 de ce tutoriel est :

<pre>
<script language="JavaScript">

(funtion() {
var pr=confirm('Voulez-vous activer l'onglet numéro 2 ?')
if(pr==true) external.activate_tab(%max_security_id,2)
}())

</script>
</pre>

Maintenant, les sites Web ne peuvent pas utiliser votre variable "pr" et ils pourront continuer à fonctionner s'ils utilisent aussi une variable nommée "pr".
 Note : Vous devez mettre "var" avant la variable pour qu'elle soit reconnue comme étant une variable locale.

Si vous utilisez "max_activex" ou n'importe quelle autre nouvelle commande de Maxthon, soyez sûr que les utilisateurs auront un message d'erreur s'ils n'ont pas la version correcte de Maxthon. Par exemple :

<pre>
try{
external.m2_callerName(%max_security_id,'PLUGINNAME')
window.open('about:blank','_blank')
var XML=external.get_tab(%max_security_id,
external.cur_sel).external.max_activex( %max_security_id,
"Microsoft.XMLDOM")
external.get_tab(%max_security_id,external.cur_sel).close()
}
catch(err){
alert('Désolé. Ce plugin ne fonctionne qu'avec Maxthon 1.2.1 et supérieures !')
}
</pre>

= Snippets de JavaScript =

Voici diverses "snippets" en JavaScript que vous pouvez utiliser dans vos plugins :
 
Obtenir le texte sélectionné également dans les cadres (frames).
 Version Barre d'outils:

<pre>
var keyword=''
//document.frames.length is the number of frames
for(i=0;i< document.frames.length;i++) {
//the try/catch part is for external frames.
//They cause an error (acces denied)
//and this code ignores that error
try {
keyword += document.frames[i].document.selection.createRange().text
}
catch(err){}
}
//if a page doesn't have frames
keyword+=document.selection.createRange().text
</pre>

Version Barre latérale :

<pre>
//active tab
var doc = external.get_tab(max_security_id, external.cur_sel).document
var keyword=''

//doc.frames.length is the number of frames

for(i=0;i< doc.frames.length;i++) {
//the try/catch part is for external frames.
//They cause an error and this code ignores that error

try {keyword += doc.frames[i].document.selection.createRange().text}
catch(err){}
}
//if a page doesn't have frames
keyword+=doc.selection.createRange().text </pre>

 Créer un objet ActiveX (merci à That1ComputerGuy)

<pre>
function createAX(obj) {
var tempWin = window.open('about:blank','') //open a window
//create an activeX object in the new window
var axObj = tempWin.external.max_activex(%max_security_id, obj)
tempWin.close() //close the window
return axObj //return the ActiveX object
}

// The following code is not necessary, it's just for testing purposes

//run the function above
var xmlDoc = createAX('Microsoft.XMLDOM');
//wait untill the complete XML document is loaded
xmlDoc.async = false;
//load the xml document
xmlDoc.load('http://www.w3schools.com/xml/note.xml')
//alert the document
alert(xmlDoc.xml);
</pre>

Les plugins de barre latérale n'ont pas besoin de cette fonction, Ils peuvent utiliser la variable xmlDoc = external.max_activex(max_security_id,'Microsoft.XMLDOM') directement.
 
Charger/sauvegarder facilement les fichiers (ini) avec ces fonctions :

<pre>
sid=%max_security_id
pluginname='PLUGINNAME'

function WriteFile(FileName,Data) {
external.writeFile(sid,pluginname,FileName,Data)
}
function ReadFile(FileName) {
return external.readFile(sid,pluginname,FileName)
}
function WriteIni(Key, Data) {
external.m2_writeIni(sid, pluginname,"plugin.ini","Settings", Key, Data)
}
function ReadIni(Key, Default) {
return external.m2_readIni(sid,
pluginname,"plugin.ini","Settings", Key, Default)
}
</pre>

Maintenant, vous pouvez lire/écrire des fichiers comme ceci :

<pre>
//write 'thisIsATest' to text.txt, located in the plugin folder
WriteFile('text.txt','thisIsATest')

//alert the content of 'text.txt'
alert(ReadFile('text.txt'))

//alert the 'test' key in plugin.ini,
//return 'not yet defined!' if the key is not available
alert(ReadIni('test','not yet defined!'))

//write key 'test'
WriteIni('test','defined')

//alert the content of key 'test', return '' if not available
//(shouldn't happen now,
//since you have just written 'defined' to the key)
alert(ReadIni('test',''))
</pre>

Pour les plugins de barre latérale vous devrez remplacer %max_security_id par max_security_id

Insérer du (code) JavaScript extérieur dans une page Web

Cela peut être très utile si vous insérez un bouton dans une page Web et que vous voulez qu'une commande précise soit utilisée si le surfeur clique sur ce bouton.

<pre>
//create an element

elmnt=document.createElement('<script src="'+
external.m2_plugin_folder(%max_security_id, 'PLUGINNAME')+
'test.js"><\/script>');

//Add this element into the 'head' of a webpage
document.documentElement.appendChild(elmnt);
</pre>

Ceci insérera "test.js", situé dans le dossier de votre plugin, dans une page Web. Note : Vous aurez une alerte de sécurité si vous avez un site web en HTTPS, comme "gmail.com". Pour les plugins de barre latérale, vous devrez remplacer %max_security_id par max_security_id

= Mise à jour de votre plugin =

Vous devez compresser votre plugin dans un fichier archive ".zip". Tous les fichiers nécessaires doivent être dans le même dossier. Si vous ne le faites pas, les utilisateurs devront le faire eux-mêmes et cela n'est pas ni très efficace, ni très "amical ".

Il n'est pas recommandé de mettre les fichiers du plugin dans un fichier archive ".rar", car peu de gens peuvent/savent décompresser ce type de fichier.

Vous pouvez en toute sécurité enlever, s'ils existent, les fichiers "max.src" et "Thumb.db" du fichier archive compressé.

Si vous mettez à jour votre plugin n'oubliez pas de mettre à jour aussi le numéro de version, pour éviter toute confusion.

= Autres plugins =

Ces plugins peuvent être utiles aux développeurs de pages Web :
 
<ul>
<li>[http://maxthon.tarapages.com/plugins/pafiledb.php?action=file&id=468 ViewPage] By Ptma (view the source of a webpage, extra all images, view meta data and more) Une traduction française de ce plugin existe [http://www.ldfa.net/logitheque.php?fiche=21 ici]
<li>[http://maxthon.tarapages.com/plugins/pafiledb.php?action=file&id=684 DevArt] By Arthur R (view the source, view all tags, validate webpages and more)
</ul>

= Problèmes ? =

Si vous avez des problèmes avec votre plugin, ou si vous ne savez pas comment faire quelque chose, vous pouvez toujours aller voir la source d'autres plugins. Un excellent moyen pour commencer à programmer est d'essayer de modifier un plugin existant. Vous apprendrez beaucoup en regardant et en cherchant à comprendre le code de quelqu'un d'autre, mais si vous utilisez beaucoup de code prit dans un autre plugin, n'oubliez pas de demander la permission à l'auteur de ce plugin.

= Question ? =

Vous pouvez poser vos questions sur les plugins sur [http://forum.maxthon.com/forum/index.php Maxthon Forum (anglais)] ou [http://www.ldfa.net/forum/index.php Le Forum de Maxthon (français)]
 
Vous pouvez poster vos commentaires sur ce tutoriel :

© Copyright 2005. Tutorial made by Neo101.
Version 1.12 01-09-2005

<center> '''<''' [[Tutorial Plugin : 3 - Commandes de Maxthon|Partie 3: Commandes de Maxthon]] | [[Tutorial Plugin|Sommaire Plugin]] | [[Tutorial Plugin : 5 - Exemples|Partie 5 : Exemples]] '''>''' </center>

Tutorial Plugin : 3 - Commandes de Maxthon

2008-07-02T14:47:09Z

Ray1 :

Maxthon a maintenant plus de 20 commandes. De nombreuses commandes fonctionnent seulement dans les plugins, mais certaines peuvent aussi être utilisées sur des pages Web normales.

Vous pouvez appeler ces commandes avec l'objet "window.external". Parce qu'il est possible pour les pages Web d'utiliser ces commandes, de nombreuses commandes nécessitent maintenant un "security_id" (une identification de sécurité).

Un "security_id" est une variable qui ressemble à ceci : "{DCFC4598-B97C-49B6-8108-EE86F8694283}". Le "security_id" change chaque fois que vous relancez votre navigateur.''

*'''Pour les plugins de script''', vous devez utiliser '''%max_security_id''' dans le fichier de script, tels que ''''var security_id=%max_security_id'''', alors vous pourrez utiliser ''''security_id'''' dans votre script. NOTE : Les pages Web sont capables d'obtenir cette variable '''security_id''' si vous lancez un plugin sur une page Web et si la page Web connaît la variable que vous stockez dans le '''max_security_id'''. Vous pouvez éviter un ''litige de sécurité'' si vous mettez tout votre code dans une fonction anonyme. [Vous trouverez plus d'informations sur les fonctions anonymes dans la 4ème Partie].

*'''Pour les plugins de barre latérale''', un fichier nommé '''"max.src"''' sera créé dans le dossier de votre plugin avec la variable '''max_security_id''' comme étant le '''security_id'''. Vous pouvez inclure ce fichier dans votre page html pour obtenir l'"'''id'''" ('''identifiant''').

Comme ceci : <pre><lang="html4strict"><script language="JavaScript" type="text/JavaScript"
src="max.src"></script></pre>

Ce code devrait être placé à l'intérieur de la balise <head>.

Vous trouverez ci-dessous, les commandes DHTML de Maxthon, n'oubliez pas de les faire précéder de 'external' ! :

*readFile( security_id, plugin_name, file_name) Où 'plugin_name' fait référence au nom du plugin défini dans le fichier plugin.ini et 'file_name' indique le nom du fichier qu'il veut lire (situé dans le dossier plugin). Ce nom de fichier peut comporter un chemin, tel que 'data\settings.ini' pour lire le fichier 'settings.ini' dans le dossier 'data'. Le nom de fichier peut également comporter '..' pour lire le dossier parent, par exemple : '..\..\config\plugins.ini' pour lire le fichier plugin.ini dans le sous-dossier 'Maxthon\config'. Vous ne pouvez pas utiliser '..' plus de deux fois, ainsi vous ne pourrez pas lire/écrire des fichiers en dehors du dossier où Maxthon est situé (pour une meilleure sécurité). La commande retournera le contenu du fichier. Si le plugin n'est pas activé, ou si le nom du plugin n'est pas correct ou n'est pas trouvé, la commande échouera et retournera "null". Cette commande ne peut que lire des fichiers texte au format ANSI.

<pre>var text = external.readFile(%max_security_id,"Test plugin",
"export.txt");</pre>

*writeFile( security_id, plugin_name, file_name, content ) Cette fonction ne peut être utilisée que dans un script de plugin, pour des raisons de sécurité. 'plugin_name' se réfère au nom du plugin défini dans plugin.ini et 'file_name' indique le nom du fichier qui doit être écrit. 'content' est le contenu qui sera écrit dans le fichier. Si le plugin n'est pas capable d'écrire ou que le nom du plugin et erroné ou non trouvé, la fonction se terminera sur une erreur et retournera "null". Cette commande peut seulement écrire des fichiers au format texte. Aussi, la commande ajoute un caractère NULL à la fin du fichier. Celà n'a pas beaucoup d'importance, mais rend impossible d'écrire un fichier au format XML. Vous devez utiliser pour cela FileSystemObject (un composant ActiveX). Notez : Le fichier sera écrasé à partir du début. Pour ajouter du contenu à un fichier, lire la donnée du premier fichier, puis ajouter la nouvelle donnée et écrire la donnée.

<pre>external.writeFile(%max_security_id,"Test plugin","setting.ini",
"username=abc\npass=qwrxcv");</pre>

*m2_readIni( security_id, plugin_name , file_name , section_name , key , default_value) Cette fonction lira la clé dans le fichier ini spécifié par 'file_name' dans le répertoire du plugin. Elle retournera 'default_value' si la clé n'est pas disponible ou si 'file_name' ou 'plugin_name' sont erronés.

<pre>path = external.m2_readIni(%max_security_id,"testplugin","settings.ini",
"general","save","0");</pre>

*m2_writeIni( security_id , plugin_name , file_name , section_name , key , value ) Cette fonction écriera la clé avec 'value' dans le fichier ini spécifié par 'file_name'.

<pre>external.m2_writeIni(%max_security_id,"testplugin","settings.ini",
"general","save","true");</pre>

*tab_count Cette commande retourne le nombre total d'onglets ouverts sous la forme d'un entier, comme le "Nombre d'onglets" dans la barre d'état.

<pre>var total_tab = external.tab_count;</pre>

*activate_tab( security_id , index ) Cette fonction active l'onglet numéro 'index' dans Maxthon ('index' commence à 0).

<pre>external.activate_tab(%max_security_id,2);</pre>

*close_tab( security_id , index ) Cette commande fermera l'onglet numéroté selon son 'index' dans Maxthon ('index' commence à zéro).

<pre>external.close_tab(%max_security_id,2);</pre>

*get_tab( security_id , index ) Cette fonction retournera un objet de page web de l'onglet numéro 'index' ('index' commence à zéro). Vous pouvez l'utiliser si vous avez besoin d'information sur cet onglet, comme le titre ou l'adresse URL.

<pre>external.get_tab(%max_security_id,2).document;</pre>

* cur_sel Cette fonction retournera le numéro (en commençant à zéro) de l'onglet courant sous la forme d'un entier.

<pre>var cur_tab = external.cur_sel;</pre>

*m2_plugin_folder( security_id , plugin_name ) Cette fonction retournera le répertoire local du plugin. Vous pouvez utiliser cette commande si vous ajoutez des images locales ou une feuille de style à une page web.

<pre>var folder = external.m2_plugin_folder(%max_security_id,"Weather");
Ceci retourne par exemple : "C:\Program Files\Maxthon\Plugin\Weather"</pre>

*m2_run_cmd( security_id , id ) Cette fonction appellera une commande de Maxthon avec l'ID spécifié. L'id de chaque commande est présent dans le fichier de chaque langue ou [http://maxthon.neo101.nl/tutorial/files/commands.txt ici].

<pre>external.m2_run_cmd(%max_security_id,32772); //Ouvre une page vierge.</pre>

*m2_callerName( security_id, plugin_name) Cette fonction indique à Maxthon que l'appel est réalisé à partir d'un Plugin. C'est habituellement utilisé avant un appel 'window.open()' pour que Maxthon ne tienne pas compte de la fenêtre popup que le plugin ouvre. La fenêtre ouverte conservera le focus si vous utilisez cette fonction.

<pre>external.m2_callerName(%max_security_id,"ViewSource!");</pre>

*max_showConfig( security_id, plugin_name) Cette fonction affichera la boîte de dialogue de configuration des plugins (aller dans la 2ème partie de ce tutoriel pour obtenir plus d'information sur la fenêtre de configuration).

<pre>external.max_showConfig(%max_security_id,"ViewSource!");</pre>

*max_activex(security_id, prog_id) Cette fonction créera un contrôle ActiveX avec le 'prog_id'. Ce contrôle ActiveX a plus de droits qu'un contrôle ActiveX normal, vous pouvez l'utiliser même si vous avez des options de sécurités hautes, mais il est encore possible qu'un antivirus bloque le composant. Vous devez ouvrir un nouvel onglet sous peine d'obtenir cette alerte : Cette commande ne peut seulement être appelée d'une page locale. Un nouvel onglet est une 'page locale' pour Maxthon.

<pre>var XML=external.max_activex(%max_security_id,"Microsoft.XMLDOM");</pre>

*max_modelessDialog( security_id , url , option , attr , window ) Cette fonction ouvrira un 'modelessDialog'. C'est la même chose que la fonction 'window.ShowModelessDialog'. Le dernier paramètre 'window' est l'objet fenêtre de la page web.

<pre>external.max_modelessDialog(%max_security_id,'example.htm',
window,'status:no;help:no;resizable:yes;scroll:yes;',window);</pre>

*max_language_id Cette propriété retourne le code de la langue en cours. Vous pouvez consulter tous les codes de langue [http://www.maxthon.com/files/documents/language_id.htm ici]

<pre>var language=external.max_language_id;</pre>

*max_actSideBarItem( plugin_name ) Cette fonction activera le plugin de la barre latérale nommé 'plugin_name'.

<pre>external.max_actSideBarItem("Calculator++");</pre>

*addFavorite( url , title ) , addFavorite( url ) Cette fonction demandera à l'utilisateur d'ajouter l''url' dans les favoris, en utilisant 'title' comme nom d'url.

<pre>external.addFavorite( "http://www.google.com" ); </pre>
<pre>external.addFavorite( "http://www.google.com","C'est google");</pre>

*addProxy (name, address, speed, is_web_proxy) Cette fonction appellera la boîte de dialogue d'ajout d'un proxy de Maxthon pour ajouter le nom du proxy 'name' à l'adresse 'address', en indiquant comme vitesse initiale 'speed'. Le 'is_web_proxy' indique si le proxy est un proxy web ou un proxy normal.

<pre>external.addProxy("Mon proxy","192.168.1.0:8080",1,0);</pre>

*addFilter( address ) , addFilter( address, is_pop_filter ) Cette fonction appellera la boîte de dialogue d'ajout d'un filtre de Maxthon, en indiquant l'adresse à filtrer 'address', 'is_pop_filter' indiquant si le type de filtre par défaut est un filtre de popup.

<pre><nowiki>external.addFilter("http://www.yahoo.com/ad*");</nowiki></pre>
<pre><nowiki>external.addFilter("http://www.yahoo.com/img/*", 0);</nowiki></pre>

*m2_addSearchEngine(name, address) Cette fonction appellera la boîte de dialogue d'ajout d'un moteur de recherche de Maxthon.

<pre><nowiki>javascript:external.m2_addSearchEngine('SteadySearch',
'http://www.steadysearch.com/search?p=Q&ts=ne&w=%us');</nowiki></pre>

*m2_search_text( security_id ) Cette propriété retournera le texte présent dans la barre de recherche de Maxthon.

<pre>var text = external.m2_search_text(%max_security_id);</pre>

Dans un plugin de barre latérale vous pouvez insérer une fonction script appelée max_callback(status).

<ol>
<li>
Quand le plugin est créé l'adresse URL sera filename?maxcmd=init
</li>
<li>
Quand le plugin est activé, max_callback('sidebar_activate') sera appelé
</li>
<li>
Quand le plugin est désactivé, max_callback('sidebar_deactivate') sera appelé
</li>
<li>
Quand l'onglet actif est modifié, max_callback('sidebar_tab_change') sera appelé
</li>
<li>
Quand le plugin sera fermé, max_callback('sidebar_unload') sera appelé.
</li>
</ol>

<center> '''<''' [[Tutorial Plugin : 2 - Fichiers Plugin|Partie 2 : Fichiers Plugin]] | [[Tutorial Plugin|Sommaire Plugin]] | [[Tutorial Plugin : 4 - Astuces|Partie 4 : Astuces]] '''>''' </center>

Tutorial Plugin : 2 - Fichiers Plugin

2008-07-02T14:43:19Z

Ray1 :

__TOC__

Les Plugins sont rangés dans le dossier "Maxthon\plugin\NOM_PLUGIN", par exemple "Maxthon\plugin\Viewpage" correspond au plugin ayant pour nom "viewpage" rangé dans le dossier Plugin de Maxthon.

Chaque plugin a son propre dossier.

Il y a, au minimum, 3 fichiers nécessaires pour un plugin, tous stockés dans le dossier portant le nom du plugin :

* plugin.ini
* nom_icon.ini
* Fichier.html

Les noms de l'icône et du fichier doivent être définis dans le fichier plugin.ini.

= Plugins de barre d'outils =

Le fichier plugin.ini ressemble à ceci, pour un plugin de barre d'outil :

<table width="95%" border=0 style="text-align:left">
<tr><th>[General]</th><td> </td></tr>
<tr><th>Name=Tester</th><td>Le nom du plugin</td></tr>
<tr><th>Author=neo101</th><td>L'auteur du plugin</td></tr>
<tr><th>Version=2.1b</th><td>Le numéro de version</td></tr>
<tr><th>ModuleType=SCRIPT</th><td>Le type de plugin. Doit être COM, EXE ou SCRIPT</td></tr>
<tr><th>FileName=test.html</th><td>Nom du fichier de script qui sera lancer si vous appuyez le bouton</td></tr>
<tr><th>Comments=Test Plugin</th><td>Ces commentaires seront visibles dans "Options de Maxthon -> Plugin -> Plugin de Maxthon"</td></tr>
<tr><th>Type=M2Plugin_BUTTON</th><td>Type de plugin, peut être M2Plugin_BUTTON ou M2Plugin_SIDEBAR (pas sensible à la casse)</td></tr>
<tr><th>HotIcon=testhot.ico</th><td>Icône qui sera visible lors du survol du bouton par la souris</td></tr>
<tr><th>Icon=test.ico</th><td>Icône qui sera toujours visible dans la barre de plugins (Peut être le même que HotIcon)</td></tr>
<tr><th>[MyIE2Buttons]</th><td>Le menu déroulant (pas requis si vous n'en avez pas besoin)</td></tr><tr><th>Count=3</th><td>Nombre d'éléments visibles dans le menu déroulant</td></tr>
<tr><th>Name1=Test1</th><td>Nom du 1er élément du menu déroulant</td></tr>
<tr><th>FileName1=test1.html</th><td>Nom de fichier du 1er élément (Peut être le même que FileName dans General)</td></tr>
<tr><th>Name2=Test2</th><td> </td></tr>
<tr><th>FileName2=scripts/test2.html</th><td>Si le fichier est dans le sous-répertoire 'scripts'</td></tr>
<tr><th>Name3=Settings...</th><td>  </td></tr>
<tr><th>FileName3=Config_caller.html</th><td> </td></tr>
<tr><th>[Settings]</th><td>Vous pouvez ajouter vos propres paramètres dans ce fichier (utile pour la configuration mais pas obligatoire)</td></tr>
<tr><th> NewWindow=true</th><td> </td></tr>
<tr><th> Neo101IsNice=true</th><td> </td></tr>
</table>

Vous pouvez télécharger un fichier "plugin.ini" de barre d'outils
[http://maxthon.neo101.nl/tutorial/plugin.ini ici]

= Plugins de barre latérale =

Le fichier "plugin.ini" ressemble à ce qui suit, pour un plugin de barre latérale :

<table width="95%" border=0 style="text-align:left">
<tr><th>[General]</th><td> </td></tr>
<tr><th>Name=Tester</th><td>Le nom du plugin</td></tr>
<tr><th>Author=neo101</th><td>L'auteur du plugin</td></tr>
<tr><th>Version=2.1b</th><td>Le numéro de version</td></tr>
<tr><th>ModuleType=SCRIPT</th><td>Le type de plugin. Doit être COM, EXE ou SCRIPT</td></tr>
<tr><th>FileName=test.html</th><td>Nom du fichier de script qui sera lancer si vous appuyez le bouton</td></tr>
<tr><th>Comments=Test Plugin</th><td>Ces commentaires seront visibles dans "Options de Maxthon -> Plugin -> Plugin de Maxthon"</td></tr>
<tr><th>Type=M2Plugin_SIDEBAR</th><td>Type de plugin, peut être M2Plugin_BUTTON ou M2Plugin_SIDEBAR (pas sensible à la casse)</td></tr>
<tr><th>HotIcon=testhot.ico</th><td>Icône qui sera visible lors du survol du bouton par la souris</td></tr>
<tr><th>Icon=test.ico</th><td>Icône qui sera toujours visible dans la barre de plugins (Peut être le même que HotIcon)</td></tr>
<tr><th>[Settings]</th><td>Vous pouvez ajouter vos propres paramètres dans ce fichier (utile pour la configuration mais pas obligatoire)</td></tr>
<tr><th> NewWindow=true</th><td> </td></tr>
<tr><th> Neo101IsNice=true</th><td> </td></tr>
</table>

Vous pouvez télécharger un fichier "plugin.ini" pour la barre latérale
[http://maxthon.neo101.nl/tutorial/files/plugin.ini ici]

= Fenêtre de configuration =

Depuis la version 1.1.090 [du 9/12/2004], les plugins de script peuvent utiliser la fenêtre de configuration :

[[image:chat.png]]

* '''Pour les Plugins de barre d'outils''' :

Vous pouvez appeler cette fenêtre si vous ajoutez un article d'appel dans le fichier plugin.ini qui crée un lien vers un fichier avec le code suivant :

<script language="JavaScript"> external.max_showConfig(%max_security_id,'PLUGINNAME') </script>

PLUGINNAME représente le nom de votre plugin.

* '''Pour les plugins de barre latérale :'''

Vous pouvez appeler la fenêtre si vous ajoutez le code suivant à votre plugin :

<a title="Montrer la fenêtre de configuration" href="javascript:external.max_showConfig(max_security_id,'PLUGINNAME')"> Config</a>

PLUGINNAME représente le nom de votre plugin.

NOTE : Vous pouvez accéder aussi à la fenêtre de configuration par le menu Options -> Options de Maxthon -> Plugin [sélectionner le plugin visé] et cliquer sur le bouton "Configurer" [s'il est accessible pour ce plugin].

Maxthon essayera d'ouvrir le fichier "config.html" se trouvant dans le dossier de ce plugin.

Un fichier "max.src" sera créé avec le "security_id" (aller voir la 3ème partie pour plus d'informations sur le "security_id").

Le fichier "config.html" doit être une page HTML normale. Vous pouvez changer les hauteur/largeur de la fenêtre avec ce code :

<meta name="Dialog-'''Width'''" content="'''110'''"> <meta name="Dialog-'''Height'''" content="'''120'''"> 

Ce code doit être placé à l'intérieur de l'élément <head>.

Télécharger un fichier "config.html" de base [http://maxthon.neo101.nl/tutorial/files/config.html ici] (clic droit -> enregistrer la cible sous ...).

=Installation d'un plugin =

Si vous mettez le fichier plugin.ini de votre plugin dans un répertoire dans le dossier Maxthon\plugin et que vous redémarrez Maxthon, alors Maxthon reconnaîtra automatiquement la présence de ce nouveau plugin.
Le nom et la version du plugin seront ajoutés dans le fichier Maxthon\config\plugins.ini lors de la fermeture de Maxthon.

Chaque fois que Maxthon démarre, il teste la présence du fichier Maxthon\config\plugins.ini, vérifie si le numéro de version a changé et si le plugin existe encore.

Si le numéro de version, l'auteur, le type de plugin ou le nom du plugin ont changé, vous pourrez voir la boîte de dialogue suivante :

[[image:plugtut4.png]]

Ceci n'arrive pas si vous modifiez le contenu d'autres fichiers/éléments.

NOTE : Les modifications de nom, de numéro de version, d'icône, de nom de fichier et de menu contextuel (pour les plugins de barre d'outils) ne prendront effet qu'après un redémarrage de Maxthon.
Les modifications du contenu des fichiers plugins sont prises en compte immédiatement. Les plugins de barre latérale doivent être réactualisés pour que les modifications prennent effet (clic droit -> Actualiser).

<center> '''<''' [[Tutorial Plugin : 1 - Introduction|Partie 1: Introduction]] | [[Tutorial Plugin|Sommaire Plugin]] | [[Tutorial Plugin : 3 - Commandes de Maxthon|Partie 3: Commandes de Maxthon]] '''>''' </center>

Tutorial Plugin : 1 - Introduction

2008-07-02T14:41:14Z

Ray1 :

__TOC__

= Les Plugins de Maxthon =

Maxthon a un très bon support des Plugins. Vous pouvez utiliser quelques Plugins d'Internet Explorer, mais également des Plugins spécifiques de Maxthon.

Les types de Plugins suivant sont supportés par Maxthon :

* Objets COM
* Fichiers .EXE
* Script

Ce tutoriel est dédié aux Plugins de type script. Ce sont les Plugins les plus simples à réaliser, bien qu'ils soient très puissants.

Vous trouverez un sommaire de toutes les commandes et des fonctions de Maxthon dans le fichier "Plugins-HowTo_fr.htm", qui se trouve dans le sous-dossier Plugin du dossier d'installation de Maxthon ou la version anglaise [http://maxthon.neo101.nl/tutorial/plugins-howto.htm ici].

Cette page donne également des informations sur les Plugins COM et EXE. Si vous voulez créer des Plugins COM ou EXE, vous avez besoin de télécharger le kit de développement de logiciel (SDK en anglais) [http://www.maxthon.com/files/sdk.zip ici]. Vous n'avez pas besoin du "SDK" pour créer des Plugins de script.

= Pour les débutants=

Si vous n'avez jamais utilisé "JavaScript" auparavant, vous pouvez l'apprendre avec l'aide que vous trouverez dans la partie "Liens utiles" (plus bas dans la page). Il est recommandé d'utiliser un programme comme [http://notepad-plus.sourceforge.net/uk/about.php Notepad++] pour écrire vos plugins. Il est possible de le faire avec le 'bloc-notes', mais ce n'est pas facile. [http://notepad-plus.sourceforge.net/uk/about.php Notepad++] dispose de la syntaxe accentuée, de la numérotation des lignes, ainsi il est plus facile de trouver les erreurs dans les plugins et il dispose également d'onglets, comme Maxthon. Voyez les différences entre le bloc-notes et [http://notepad-plus.sourceforge.net/uk/about.php Notepad++]:

Dans le Bloc-notes :

[[image:plugtut3.png]]

Dans [http://notepad-plus.sourceforge.net/uk/about.php Notepad++] :

[[image:plugtut2.png]]

= Liens Utiles =

Ces liens sont des références pratiques si vous débutez dans l'apprentissage des langages HTML et/ou JavaScript.

[http://www.w3schools.com/js/default.asp W3School JavaScript Tutorial] (Recommandé pour les débutants).

[http://www.w3schools.com/htmldom/dom_reference.asp W3School HTML DOM reference] (HTML DOM vous permet d'ouvrir et de modifier des documents au format HTML).

[http://www.w3schools.com/htmldom/dom_reference.asp W3School HTML DOM reference] (Toutes les balises Html).

[http://msdn.microsoft.com/library/default.asp?url=/library/en-us/script56/html/js56jsoriJScript.asp Microsoft MSDN JavaScript reference/guide]

[http://msdn.microsoft.com/library/default.asp?url=/workshop/author/dhtml/reference/dhtml_reference_entry.asp Microsoft MSDN HTML/DHTML reference]

[http://www.devguru.com/Technologies/ecmascript/quickref/javascript_index.html Devguru JavaScript reference]

= Les différents types de plugins =

Il y a deux sortes de plugins : les plugins de barre d'outils et les plugins de barre latérale.

[[image:plugtut1.jpg]]

== Les plugins de barre latérale ==

* Les plugins de barre latérale peuvent être construits comme des pages Web normales, par exemple :

<nowiki><html>
<head>

<script language="JavaScript" type="text/JavaScript" src="max.src">
</script>
</head>
<body>
<h1>Plugin très simple</h1>
<a href="http://www.maxthon.com" target=_blank>Maxthon.com</a>
<a href="javascript:external.activate_tab(max_security_id,2)">
Activer l'onglet 2</a>
</body>
</html></nowiki>

[http://maxthon.neo101.nl/tutorial/files/TemplateSidebar.html Télécharger un modèle de plugin de barre latérale] (Clic droit -> Enregistrer la cible sous ...)

* Les plugins de barre latérale ne fonctionnent pas sur la page active. Ce sont des pages locales (en fait, le panneau latéral), mais avec la commande 'external.get_tab', ils peuvent modifier la page active. Vous trouverez des explications complémentaires dans la 3ème partie.

== Les plugins de barre d'outils ==

* Les plugins de barre d'outils peuvent être entre des balises, par exemple :

<script language="JavaScript">
pr=confirm('Voulez-vous activer l\'onglet numéro 2?')
if(pr==true) external.activate_tab(%max_security_id,2)
</script>

[http://maxthon.neo101.nl/tutorial/files/TemplateToolbar.html Télécharger un modèle de plugin de barre d'outils] (Clic-droit -> Enregistre la cible sous ...)

* Les plugins de barre d'outils fonctionnent dans la page active. document.body.innerHTML, par exemple, affiche le contenu (la source) de la page web active.

<center> '''<''' [[Plugins de Maxthon|Sommaire Plugin]] | [[Tutorial Plugin : 2 - Fichiers Plugin|Partie 2 : Fichiers Plugin]] '''>''' </center>

Caractéristique : Groupes

2008-07-02T14:36:35Z

Ray1 :

__TOC__

Un groupe est une collection d'adresses URL avec laquelle les utilisateurs de Maxthon peuvent ouvrir certaines pages Web en une seule fois.

==Vous pouvez créer les groupes de 3 manières différentes :==

=== - À partir des options de Maxthon===
Allez dans le menu '''Groupes -> Organiser les groupes...''', cela ouvrira la boîte de dialogue '''Organiser les groupes'''.

[[image:ch09-07.png]]

Cliquez sur l'icône '+' verte (à gauche) pour créer un nouveau groupe, donnez-lui un nom et vous pourrez ensuite ajouter des adresses URL à ce groupe à l'aide de l'autre icône verte (à droite). Pour renommer le groupe, cliquez deux fois sur son nom (comme lorsque vous renommez un fichier dans l'Explorateur Windows) et appuyez sur Entrée lorsque vous avez terminé. 
Vous pouvez déplacer les adresses URL d'un groupe à l'autre en glissant/déplaçant l'URL au dessus du nom du groupe. 
Vous pouvez également ouvrir une URL d'un groupe dans un nouvel onglet en double-cliquant dessus. 

=== - À partir du menu Groupes===
Allez dans le menu '''Groupes -> Enregistrer les onglets en cours comme groupe..''', Maxthon ouvrira une boîte de dialogue '''Enregistrer sous''' où vous devrez saisir le nom du nouveau groupe et cliquer sur Enregistrer. 

=== - À partir du menu contextuel de l'onglet===
Cliquez-droit sur l'onglet et allez dans '''Envoyer vers -> Groupes > [liste des groupes]''' et sélectionnez le groupe dans la liste dans lequel vous voulez ajouter l'onglet en cours. 

{| style="color:#FF6600; background:#FFF6E0; border: 1px solid #FF9900"
| [[image:tip.png]] Les groupes de Maxthon sont compatibles avec les groupes de Netcaptor ce qui signifie que vous pouvez transférer vos fichiers groupes *.Cgp dans le répertoire des groupes de Maxthon.
|}

==Utilisation des groupes :==

Lorsque vous voulez ouvrir un groupe, allez dans le menu Groupes et cliquez sur le groupe que vous souhaitez ouvrir.

[[image:ch09-06.png]]

À partir du même menu, si vous voulez ouvrir une URL spécifique du groupe, cliquez droit sur son nom pour ouvrir la liste des URL et cliquez sur celle que vous voulez ouvrir, ainsi vous n'avez plus besoin de votre barre des Favoris ;-). Vous pouvez également configurer un groupe en tant que groupe de démarrage en cochant la case devant le nom du groupe dans la boîte de dialogue '''Organisation des groupes'''. Ensuite, vous pouvez aller dans le menu '''Options de Maxthon -> Général -> Au démarrage''' et sélectionner '''Ouvrir le groupe de démarrage''' comme mode de démarrage.

{| style="color:#FF6600; background:#FFF6E0; border: 1px solid #FF9900"
| [[image:tip.png]] Si vous n'aimez pas que vos groupes soient tous ouverts en une seule fois, vous pouvez modifier l''''Intervale entre chaque ouverture''' du menu '''Options de Maxthon -> Onglet -> Général'''.
|}

<center> '''<''' [[Caractéristique : Outils externes]] | [[Caractéristiques de Maxthon|Index]] | [[Accueil]] '''>''' </center>

Caractéristique : Outils externes

2008-07-02T14:35:09Z

Ray1 :

__TOC__

N'est-ce pas plus pratique d'avoir ses applications préférées sous la main lorsqu'on surfe sur le Web ? N'est-ce pas plus pratique qu'elles se lancent et s'arrêtent automatiquement avec Maxthon ? OUI ! Bingo. Bien, en activant la caractéristique '''Outils externes''', Maxthon peut vous proposer la fonctionnalité ultime que vous avez toujours désirée !

==Comment paramétrer les Outils externes :==

# Sélectionnez le menu '''Outils -> Outils externes -> Organiser les outils externes'''.
# Dans cette boîte de dialogue, utilisez les boutons '''+''', '''-''','''...''' pour ajouter, supprimer, modifier ou trier les outils externes.

[[image:externaltool01.png]]

Si vous souhaitez qu'une application démarre en même temps que Maxthon, sélectionnez l'application et cochez la case '''Démarrer avec Maxthon''' ou '''Fermer avec Maxthon''' (vous pouvez sélectionner les deux si vous voulez).

L'info-bulle de l'application qui démarrera avec Maxthon commencera par une *. Ceci indique qu'il démarrera avec Maxthon. Vous pouvez également ajouter des arguments, comme l'adresse URL en cours de l’outil externe. Ceci permet par exemple de visualiser l'adresse URL en cours avec un autre navigateur (je ne pense pas que vous ayez besoin de cette option, étant donné que Maxthon est le meilleur, mais c'est juste au cas où....;). 
Vous pouvez également cocher l'option '''Demander arguments''', ainsi Maxthon vous demandera les arguments à chaque démarrage de cet outil externe.

Avec Maxthon, vous pouvez facilement exécuter des programmes externes. Vous pouvez voir les outils externes que vous avez ajoutés dans la Barre d'outils externes ('''Affichage -> Barre d'outils'''), dans le bouton 'Utilitaires' de la barre de boutons standard ('''Affichage -> Barre d'outils -> Personnaliser la barre d'outils...'''), ou dans le menu '''Outils -> Outils externes'''.

[[image:ch09-03.jpg]]

<center> '''<''' [[Caractéristique : Tueur de pub]] | [[Caractéristiques de Maxthon|Index]] | [[Caractéristique : Groupes]] '''>''' </center>

Caractéristique : Tueur de pub

2008-07-02T14:33:42Z

Ray1 :

__TOC__

Maxthon peut bloquer aussi bien les fenêtres Popup que les éléments de contenu (comme les bannières). Il utilise une liste de filtres pour bloquer les éléments, mais le bloqueur de Popup possède également un mode automatique, qui n'utilise pas de liste de filtre.

* Le filtre de Popup est utilisé pour bloquer les pages Web de publicité. En ajoutant l'adresse URL de ces pages Web au filtre de Popup, Maxthon les bloquera en les empêchant d'apparaître. Par exemple : '''http://www.poq.com/popup/*.htm''' bloquera toutes les pages .htm de l'adresse '''http://www.poq.com/popup/'''.

* Le filtre de contenu est utilisé pour bloquer le contenu d'une page Web que l'utilisateur ne veut pas voir, tel que les fichier .gif publicitaires présents sur certaines pages Web, les scripts ajoutés (utilisés par Adsense de Google) ou les animations gênantes au format Flash. En ajoutant l'adresse URL des fichiers gif/flash dans le filtre de contenu, Maxthon les bloquera. Par exemple : '''http://www.poq.com/products/ad*.swf''' bloquera tous les fichiers au format flash dont le nom commence par 'ad' et l'adresse URL contient '''http://www.poq.com/products/'''.

{| style="color:#FF6600; background:#FFF6E0; border: 1px solid #FF9900"
| [[image:tip.png]] Le caractère * peut être utilisé dans le texte du filtre pour remplacer n'importe quelle chaîne de caractères, tandis que le caractère ? sera utilisé pour remplacer n'importe quel caractère unique.
|}

==Configuration des filtres==

La manière la plus simple pour ajouter ou modifier les filtres est d'aller dans le menu '''Options -> Options de Maxthon -> Tueur de pub'''. Vous pouvez ajouter, supprimer ou modifier les filtres.

===Filtres de Popup===

Une autre façon d'ajouter une adresse URL aux filtres de Popup^est d'utiliser un clic-droit sur l'onglet de la page Web et de sélectionner '''Envoyer à -> Filtres..''', ou d'utiliser le raccourci clavier Ctrl+Q. 
Maxthon affichera alors une boîte de dialogue pour vous permettre de configurer les filtres. Vous pouvez également sélectionner l'élément '''Filtre de contenu'''. Vous pouvez également éditer l'adresse URL ou utiliser le caractère joker '''*''' dans le texte du filtre. 

[[image:adhunter02.png]]

===Filtre de contenu===

Parfois, vous pourrez avoir des difficultés pour trouver l'adresse URL de l'image/l'animation flash ennuyeuse à ajouter au filtre de contenu. Il y a une option pour rendre cela plus facile, elle se trouve dans le menu '''Options -> Options de Maxthon -> Tueur de pub'''. Cochez la case à côté de l'élément '''Ajouter le "Tueur de pubs " au menu contextuel du navigateur'''. Avec cette option, vous serez capable de cliquer droit sur l'image de la page Web et de sélectionner '''Ajouter au tueur de pubs '''. Si vous voulez qu'un site ne soit pas filtré, vous pouvez l'ajouter à la liste des exceptions.

{| style="color:#FF6600; background:#FFF6E0; border: 1px solid #FF9900"
| [[image:tip.png]] Vous pouvez temporairement désactiver le tueur de pubs en maintenant enfoncé la touche CTRL lors du chargement de la page !
|}

Vous pourrez trouver la signification de toutes les options du tueur de pubs [[Le tueur de publicités|ici]].

<center> '''<''' [[Caractéristique : Proxy]] | [[Caractéristiques de Maxthon|Index]] | [[Caractéristique : Outils externes]] '''>''' </center>

Caractéristique : Proxy

2008-07-02T14:31:58Z

Ray1 :

__TOC__

L'utilisation d'un serveur Proxy peut augmenter la vitesse de navigation sur Internet. Lorsque qu'un DNS a un problème, les serveurs Proxy indirectement font acte de serveurs DNS et surmontent beaucoup de limitations du réseau à travers les services Proxy.

L'utilisation des serveurs Proxy dans IE n'est pas très pratique.
Maxthon accroît les fonctions des serveurs Proxy pour une plus grande facilité d'utilisation et de paramétrage.

==Configuration des services Proxy==

Allez dans Options > Options de Maxthon > Proxy " pour ajouter, modifier et effacer les serveurs Proxy.

Cliquez sur le bouton '''+''' pour ajouter un nouveau serveur Proxy et une boîte de dialogue s'ouvrira afin de pouvoir l'ajouter. Vous pouvez nommer un serveur Proxy et utiliser une indication de vitesse pour différencier la vitesse de chaque Proxy.

[[image:proxy01.png]]

Lorsque vous ajoutez desserveurs Proxy à la liste, vous devez utiliser cette syntaxe :

*Adresse : Port Par exemple : 218.30.16.115:80 (ce format définira tous les protocoles utilisant le même serveur Proxy).
* Protocole = adresse:Port Par exemple : Socks = 202.124.41.2:1080 (ce format peut définir un protocole individuel utilisé par différents serveurs Proxy).

==Configuration du "Bypass"==

Vous pouvez configurer quels sites Web n'utiliseront pas de serveurs Proxy.
Vous pouvez utiliser un astérisque * pour remplacer le nom de domaine, le nom de la machine principale ou l'adresse. Vous pouvez "bypasser" plus d'un seul site Web en laissant un espace blanc entre chaque élément. Habituellement, le premier élément <local>
représente une machine locale avec l'adresse IP : 127.0.0.1
 
Par exemple : <local> www.*.maxthon.* 201.* *.Mygroup.*

==Utilisation des serveurs Proxy==

Si vous avez déjà configuré des serveurs Proxy, vous pouvez utiliser les deux façons suivantes pour activer ou désactiver les serveurs Proxy :

# Utilisez le menu "Options -> Proxy " Pour activer ou désactiver les serveurs Proxy.
# Utilisez le bouton de la barre d'outils "Serveur Proxy" pour changer rapidement de serveur Proxy. C'est la manière la plus simple de changer de serveur Proxy.

[[image:ch09-04.png]]

{| style="color:#FF0000; background:#FFF0F0; border: 1px solid #FF9999"
| [[image:warn.png]] Les serveurs Proxy sont activés pour tous les onglets de Maxthon.
|}

<center> '''<''' [[Caractéristique : Traductions et services]] | [[Caractéristiques de Maxthon|Index]] | [[Caractéristique : Tueur de pub]] '''>''' </center>

Caractéristique : Traductions et services

2008-07-02T14:30:23Z

Ray1 :

__TOC__

Avec cette caractéristique, vous pouvez par exemple traduire la page que vous êtes en train de visualiser en utilisant le site Babelfish ou voir le taux de popularité de la page en cours en utilisant le site Alexa à partir de l'interface de Maxthon.

==Configuration de traductions et services==

Vous pouvez configurer vos services dans le menu Options > Options de Maxthon > Barre d'adresse > Services
qui ouvrira une boîte de dialogue où vous pourrez ajouter et modifier chaque service. 
Vous pouvez décocher certains services pour éviter qu'ils n'apparaissent dans les menus déroulants, sans pour autant les supprimer.

[[image:addressbar02.png]]

Par défaut, la liste contient beaucoup de services, mais vous pouvez les ajouter ou les modifier à votre convenance.
La syntaxe d'une URL de service est :
*URL + %s
Par exemple : <nowiki>http://validator.w3.org/check?verbose=1&uri=</nowiki>
%s 
Ceci testera la validité HTML de la page en cours. 
Où %s sera remplacé par Maxthon avec l'URL de l'onglet en cours.

==Utilisation de traductions et services==

Vous pouvez utiliser cette caractéristique à partir du menu "Outils -> Traductions et services -> ..."
ou à partir du bouton "Aller" sur la barre d'adresse.

[[image:ch07-04.png]]

<center> '''<''' [[Caractéristique : Touches d'URL]] | [[Caractéristiques de Maxthon|Index]] | [[Caractéristique : Proxy]] '''>''' </center>

Caractéristique : Touches d'URL

2008-07-02T14:28:47Z

Ray1 :

__TOC__

L'utilisation des touches d'URL vous permet de naviguer sur une URL prédéfinie en appuyant sur les touches de fonction F2 à F12.

==Configuration des touches d'URL==

Allez dans Options -> Options de Maxthon -> Clavier où vous pourrez facilement ajouter et modifier l'URL de chaque touche.

[[image:keyboard01.png]]

A partir de la liste, sélectionnez la touche que vous désirez configurer et cliquez sur le bouton '''Editer'''.
Saisissez l'URL de cette touche et cliquez sur la ligne suivante pour valider votre saisie.
Vous pouvez également configurer une URL pour une touche en cliquant droit sur l'onglet d'une page Web et en sélectionnant '''Définir un raccourci clavier...'''.

==Utilisation des touches d'URL==

Il est important que vous activiez tout d'abord cette caractéristique à partir du menu Options -> Utiliser les touches

{| style="color:#FF0000; background:#FFF0F0; border: 1px solid #FF9999"
| [[image:warn.png]] Si F2 et F3 sont définies comme touches d'URL, il ne vous sera plus possible de changer d'onglets en utilisant ces touches.
|}

<center> '''<''' [[Caractéristique : Recherche rapide]] | [[Caractéristiques de Maxthon|Index]] | [[Caractéristique : Traductions et services]] '''>''' </center>

Caractéristique : Recherche rapide

2008-07-02T14:26:42Z

Ray1 :

__TOC__

La Recherche rapide vous permet d'utiliser directement les mots-clés dans la barre d'adresse sans passer par la page spéciale d'un moteur de recherche.

==Configuration de la recherche rapide==

Allez dans Options -> Options de Maxthon et choisissez Recherche, où vous pourrez facilement ajouter, modifier ou supprimer des moteurs de recherche.

Cliquez sur l'icône + pour ajouter un nouveau moteur de recherche et des champs vides seront créés pour lui.

1. Indiquez le nom et l'alias du nouveau moteur (''l'alias doit être de préférence "court"'') et appuyez sur "Entrée".

* Indiquer le nom dans la colonne "nom" ;

{| style="color:#FF0000; background:#FFF0F0; border: 1px solid #FF9999"
| [[image:warn.png]] La zone nom fait référence au nom individuel du moteur de recherche. Les noms identiques doivent donc être proscrits.
|}

* Indiquer l'alias dans la zone après "Abréviation".

[[image:search01.png]]

{| style="color:#FF6600; background:#FFF6E0; border: 1px solid #FF9900"
| [[image:tip.png]] L'alias du moteur de recherche désigné par " * " correspond au '''moteur de recherche''' que Maxthon utilisera '''par défaut'''. Il ne peut y avoir qu'un seul moteur de recherche par défaut. C'est ce moteur qui sera utilisé lorsque vous saisirez des mots-clés dans la barre d'adresse.
|}

2. Saisissez, dans la zone suivant "Moteurs de", l'adresse URL utilisée par le moteur de recherche et cliquez sur l'icône de recherche. La syntaxe de l'adresse du moteur de recherche est du type :

*Adresse URL + %s

Par exemple : <nowiki>http://www.google.com/search?q=</nowiki>%s 
Où l'argument %s sera remplacé par Maxthon, par le mot-clé recherché. 
Vous pouvez aussi utiliser %us qui supporte les caractères "non-latins".

Vous pouvez cliquer sur le bouton Défaut pour remettre la liste par défaut. Cette action peut être également utilisée si Maxthon vous présente, à la suite d'une erreur interne, une liste "vide".

Sur le [http://www.maxthon.com/support/resource.htm site Web de Maxthon], vous pourrez trouver d'autres moteurs de recherche.

==Utilisation de la Recherche rapide==

1. La syntaxe à utiliser dans la barre d'adresse pour la recherche rapide est la suivante :

"Nom du moteur de recherche" ou "Alias du moteur de recherche" (espace) "mot(s)-clé" 

Exemples :

* Si vous saisissez le ''nom'' du moteur de recherche "Yahoo" dans la barre d'adresse : "Yahoo ldfa", Maxthon lance le moteur Yahoo.com et lui demande de chercher ldfa.
* Si vous saisissez "Y" (l' ''alias'' de Yahoo.com) dans la barre d'adresse : "y ldfa", Maxthon lance le moteur Yahoo.com et lui demande de chercher ldfa.
* Si vous saisissez seulement ldfa Maxthon lance le moteur de recherche par ''défaut'' (ici ''Google'' dans la copie d'écran ci-dessus) est lui demande de chercher ldfa.

[Nota : vous ne devez pas taper les " encadrant les mots exemples ci-dessus.]

[[image:quicksearch01.png]]

(Ceci utilise le moteur IMDB.com (Movie search) : imdb
| <nowiki>http://www.imdb.com/find?q=%s;tt=on;nm=on;mx=30</nowiki>) 

2. La syntaxe du moteur de recherche par défaut est la suivante : "mot(s)-clé" 

[[image:quicksearch02.png]]

(Le moteur par défaut de la recherche rapide (dans la version française de Maxthon) est : *
| <nowiki>http://www.google.com/search?q=%s&hl=fr&lr=lang_fr&ie=ISO-8859-1</nowiki>)

{| style="color:#FF6600; background:#FFF6E0; border: 1px solid #FF9900"
| [[image:tip.png]] Les mots-clés sont constitués d'une combinaison de caractères quelconques permis par les moteurs de recherche.
|}

<center> '''<''' [[Caractéristique : Alias d'URL]] | [[Caractéristiques de Maxthon|Index]] | [[Caractéristique : Touches d'URL]] '''>''' </center>

Caractéristique : Alias d'URL

2008-07-02T14:23:04Z

Ray1 :

__TOC__

Certains sites Web ont des adresses URL qu'il est difficile de retenir. Comment accéder rapidement à ces sites Web sans avoir à saisir des adresses URL trop compliquées ? Bien sûr, vous pouvez ajouter l'adresse à vos Favoris, mais Maxthon vous propose une autre alternative : les alias d'adresse URL.

La fonction alias d'URL de Maxthon permet de définir des "alias" pour certains sites Web.
Lorsque vous saisissez un alias dans la barre d'adresse, Maxthon ouvrira la page de l'URL correspondante.

==Configuration des alias d'URL==

Allez dans le menu Options -> Options de Maxthon -> Barre d'adresse -> Alias d'URL, cliquez sur le + (pour ajouter un alias) et saisissez une suite de caractères qui serviront d'alias (à l'exception de ":" ou "."). Par exemple : vous pouvez attribuer la lettre "m" à l'adresse de <nowiki>www.microsoft.com</nowiki>. Ainsi, lorsque vous saisirez m dans la barre d'adresse, Maxthon lancera <nowiki>www.microsoft.com</nowiki>.

{| style="color:#FF6600; background:#FFF6E0; border: 1px solid #FF9900"
| [[image:tip.png]] Vous pouvez également créer un nouvel alias d'URL en cliquant droit sur l'onglet de la page et en sélectionnant l'option '''Définir un alias d'URL...'''.
|}

[[image:addressbar03.png]]

{| style="color:#FF0000; background:#FFF0F0; border: 1px solid #FF9999"
| [[image:warn.png]] Lorsque les 'Alias d'URL' et la 'Recherche rapide' sont tous les deux actifs, les 'Alias d'URL' sont prioritaires. Cela signifie que si vous avez le même nom pour un 'Alias d'URL' et pour une 'Recherche rapide', Maxthon l'interprétera comme un nom d'alias plutôt que comme un mot-clé de à rechercher. Si vous préférez la recherche rapide, il est souhaitable de ne pas utiliser le même nom.
|}

<center> '''<''' [[Caractéristiques de Maxthon]] | [[Caractéristique : Recherche rapide]] '''>''' </center>

Menu Aide

2008-07-02T14:08:28Z

Ray1 :

[[image:menu_help01.png]]

;A propos de Maxthon...: Ouvre une boîte de dialogue avec diverses informations, comme le numéro de la version utilisée.

;Aide de Maxthon: Ouvre l'aide en ligne, dont celle où vous êtes actuellement.

;Astuce du jour...: Affiche l'astuce du jour.

;Rechercher une mise à jour...: Ouvre la boîte de dialogue de mise à jour qui vous permet d'installer les mises à jour de Maxthon.

;Faire un don (merci): Maxthon est gratuit, ce qui signifie que vous pouvez l'utiliser gratuitement pour une activité non commerciale. Si vous appréciez Maxthon, vous pouvez envoyer un don qui aidera Maxthon à devenir le meilleur navigateur. Vous trouverez plus d'informations sur la page [http://www.ldfa.net/~maxthon/fr/promote.htm Dons & promotion].

;Service d'appréciation...: Pour vous remercier de votre "don", vous aurez accès à notre "Service d'appréciation", qui fera apparaître votre nom dans la boîte "À propos de Maxthon" et permettra l'accès à divers autres services. Vous trouverez plus d'informations en consultant la page [http://www.ldfa.net/~maxthon/fr/support/faq.htm#appr_service FAQ].

;Promouvoir Maxthon: Ouvre la page de promotion de Maxthon, avec les bannières et autres. ''C'est là que vous pouvez dire tout le bien que vous pensez de Maxthon.''

;Envoyer un compte-rendu à l'auteur: Ouvre une fenêtre avec les informations sur votre système, au moment du "bug", que vous pouvez envoyer à l'auteur de Maxthon avec votre rapport d'erreur.

;Site Web de Maxthon: Dernières informations sur le programme, obtenir des "skins", des plugins et plus encore... ''Nota : Maxthon se souviendra du langage que vous avez sélectionné sur le site de Maxthon.''

;Forum de Maxthon: Lorsque vous avez une question, c'est l'endroit où vous pourrez trouver une réponse... (en anglais). Pour le forum en français, il faut aller [http://www.ldfa.net/forum/index.php?act=idx ici]

<center> '''<''' [[Menu Fenêtres]] | [[Accueil]] '''>''' </center>

Menu Options

2008-07-02T14:03:23Z

Ray1 :

[[image:menu_options01.png]]

;Tueur de pubs : Le tueur de pubs est un système interne de Maxthon qui bloque les publicités envoyées par les sites. Vous pouvez trouver toutes les options du Tueur de pub dans le menu Options > Options de Maxthon > Tueur de pubs. Il s'agit du même menu que celui auquel vous pouvez accéder par l'icône "Activer/désactiver tous les filtres" située sur la barre d'état.

;Proxy: Ici vous pouvez ajouter, modifier, supprimer des serveurs Proxy. Ajoute des serveurs Proxy à la liste située sous le dossier Proxy. Si vous avez déjà installé des serveurs Proxy, vous devez utiliser une des deux manières suivantes pour activer ou désactiver les serveurs Proxy : 
# Utiliser la commande du menu Options > Proxy pour activer ou désactiver les serveurs Proxy.
# Utiliser le bouton 'Proxy' (si vous l'avez installé, bien sûr !) de la barre d'outils principale, pour passer rapidement d'un Proxy à un autre.

;Contrôle du chargement: Ici vous pouvez définir ce que vous voulez que Maxthon affiche, permette ou non. Cochez ou décochez :

*'''Charger''' les images, les vidéos ou le son.

*'''Autoriser''' la lecture des scripts, des applets Java, des contrôles ActiveX ou les animations Flash.

{| style="color:#FF0000; background:#FFF0F0; border: 1px solid #FF9999"
| [[image:warn.png]] Rappelez-vous que désactiver l'option 'Flash' affectera le comportement de tous les navigateurs basés sur Internet Explorer que vous utilisez sur votre PC !
|}

{| style="color:#FF0000; background:#FFF0F0; border: 1px solid #FF9999"
| [[image:warn.png]] Si vous désactivez les ActiveX, les animations Flash ainsi que les vidéos et sons intégrés dans les pages web ne fonctionneront plus.
|}

;Utiliser la recherche rapide dans la barre d'adresse: Maxthon vous permet de saisir directement les mots-clés de vos recherches dans la barre d'adresse. Si le moteur de recherche par défaut (défini par l'étoile ("*") dans la colonne 'Alias' de la boîte de dialogue Options de Maxthon > Recherche est Google, la barre d'adresse de Maxthon devient l'équivalent de la barre de recherche utilisée par Google.

;Utiliser les alias: Les adresses de certains sites Web sont tellement longues qu'il est difficile de les retenir. Comment avoir un accès plus rapide à ces sites sans taper leur adresse si compliquée ? 
* Pour résoudre le problème, vous pouvez les ajouter à vos favoris.
* Une autre solution est d'utiliser les Alias d'adresse URL. Ce nom veut tout dire. La fonction 'Alias d'URL' de Maxthon vous permet d'attribuer un alias à une adresse URL. Lorsque vous saisirez cet alias, Maxthon retrouvera l'adresse compliquée et l'ouvrira pour vous, à condition que vous ayez défini l'alias dans Options > Options de Maxthon > Barre d'adresse > Alias . '' Un alias peut être alphabétique ou numérique, voire une combinaison des deux''. Exemple : définir 'pj' comme alias pour le site : http://www.pagesjaunes.fr/pj.cgi?.

''Noter que la définition d'un alias peut être effectuée par un clic-droit sur le nom d'un onglet et en choisissant : Définir un alias d'Url....''

;Utiliser les touches: Les touches de fonction F2 à F12 peuvent être affectées au lancement de l'adresse d'un site dans le menu Options > Options de Maxthon > Clavier . L'appui sur la touche affectée lancera le site préprogrammé à cet endroit.

''Précision - N'oubliez pas que les touches F5 (actualiser) et F11 (plein écran) sont utiles. Affecter une adresse URL à l'une ou l'autre de ces deux touches aura pour effet de ne plus permettre l'actualisation (F5) ou de passer en plein écran (F11). Bien sûr, vous restez maître de vos choix en la matière.''

;Modes de navigation: Ils sont de trois sortes : 
# Par défaut : Les liens s'ouvrent dans le même onglet, les nouveaux onglets s'ouvrent en ''arrière-plan''.
# Standard : Les liens s'ouvrent dans le même onglet, les nouveaux onglets s'ouvrent au ''premier plan''.
# Nouveau : Les liens s'ouvrent dans un ''nouvel onglet'', les nouveaux onglets s'ouvrent en ''arrière-plan''.

;Navigateur par défaut: Vous pouvez indiquer ici (à votre système) que Maxthon est votre navigateur par défaut. ''Tous les programmes ne lanceront pas Maxthon par défaut parce qu’ils ont, en eux ("codé en dur") Internet Explorer comme navigateur à lancer par défaut.'' Vous pouvez également, dans ce menu, remettre le dernier navigateur que vous aviez par défaut.

;Barre d'état: Permet d'organiser la barre d'état et d'interdire le défilement des messages. Cochez cette option pour ne plus 'jamais' voir les messages affichés par les pages Web dans votre barre d'état (cette option est réversible, bien sûr !).

;Options de Maxthon: Vous pouvez modifier ici toutes les options de Maxthon. Nous vous recommandons de consulter l'aide spéciale sur ce sujet en allant voir les [http://www.ldfa.net/wiki/index.php/Options_de_Maxthon Options de Maxthon].

;Options Internet...: Configurez ici vos options d'Internet Explorer.

<center> '''<''' [[Menu Groupes]] | [[Menu Outils]] '''>''' </center>

Menu Groupes

2008-07-02T13:59:51Z

Ray1 :

[[image:menu_groups01.png]]

;Groupes: Un groupe est un ensemble d'URL qui peuvent être lancées en même temps, de cette façon, vous pouvez lancer un groupe de favoris en une seule fois.

;Organiser les groupes...: Ajouter, supprimer ou modifier les groupes.
* Vous pouvez paramétrer le groupe qui sera lancé au démarrage de Maxthon, en cochant la case à cocher devant le nom d'un groupe dans le menu Groupes -> Organiser les groupes.... Après avoir paramétré un groupe de démarrage, vous devez paramétrer le mode de démarrage de Maxthon dans Options de Maxthon -> Page de démarrage -> Ouvrir le groupe.
* Vous pouvez faire en sorte que l'onglet d'un site web dans un groupe ait un nom prédéfini en cochant la case devant le nom du site Web.

;Enregistrer les onglets en cours comme groupe...: Ajoute tous les onglets ouverts à un groupe. Ceci est un moyen facile de créer un groupe, il suffit de donner un nom au groupe et c'est fait !

;Ajouter au groupe: Ajouter une seule page Web à un groupe. Une boîte de dialogue apparaît dans laquelle vous pouvez modifier le nom de la page et l'URL. Vous pouvez aussi faire un clic-droit sur l'onglet de la page et sélectionner Envoyer vers -> Groupe pour ajouter la page Web à un groupe existant.

<center> '''<''' [[Menu Favoris]] | [[Menu Options]] '''>''' </center>

Menu Favoris

2008-07-02T13:58:54Z

Ray1 :

[[image:menu_favorites01.png]]

;Ajouter aux Favoris Ctrl + D: Ouvre une boîte de dialogue pour ajouter l'URL en cours à vos Favoris.

;Organiser les Favoris...: Ouvre une boîte de dialogue. Vous pouvez créer de nouveaux répertoires, renommer, déplacer et supprimer des URL.

;Service des Favoris: Ceci est une option spéciale réservée aux membres du Service d'appréciation (les personnes qui ont fait un don). Vous pouvez envoyer et télécharger vos favoris sur le serveur de Maxthon, de façon à pouvoir installer vos Favoris sur plusieurs ordinateurs ou les sauvegarder.

;Ajouter cette URL ici...: Ajoute un Favori.

;Ouvrir tous les Favoris: Attention ! Ceci ouvrira tous vos Favoris ! ;-)

<center> '''<''' [[Menu Affichage]] | [[Menu Groupes]] '''>''' </center>

Menu Affichage

2008-07-02T13:57:46Z

Ray1 :

[[image:menu_view01.png]]

;Barres d'outils: Sélectionne les barres d'outils de Maxthon à afficher ou cacher.

;Barre de menu Ctrl + F11: [[image:menu_view02.png]]

;Boutons standard: [[image:menu_view03.png]]

;Adresse: La barre d'adresse de Maxthon a quelques fonctions spéciales, telles que la Recherche rapide, les alias d'URL et les Services Web. [[image:menu_view04.png]]

;Système: Affiche les boutons spéciaux tels que Fermer, Fermer tout, Onglet suivant, Onglet précédent, Réduire, Restaurer. [[image:menu_view05.png]]

;Outils externes: Affiche la barre avec les outils externes définis dans '''Options > Options de Maxthon > Outils externes''' [[image:menu_view06.png]]

;Favoris: [[image:menu_view07.png]]

;Plugins: [[image:menu_view08.png]]

;Verrouiller les barres d'outils: Bloque les barres d'outils, ainsi vous ne pouvez plus les déplacer ni les redimensionner avec la souris.

;Texte sous les boutons: Affiche une info-bulle, sous les boutons standard, qui indique la fonction du bouton.

;Personnaliser...: Personnalise la barre d'outils, la barre de menu et la barre d'état. [[image:menu_view09.png]]

;Personnaliser la barre des boutons système: Tout est dans le nom. [[image:menu_view10.png]]

;Barre d'état: Affiche la barre d'état en bas de la fenêtre. Dessus vous pouvez :
* voir l'état actuel de la page,
* accéder rapidement au '''tueur de pubs, au mode hors connexion, activer/désactiver tous les filtres, activer les nouvelles fenêtres, ouvrir les liens dans une nouvelle fenêtre et au Post-it''',
* voir '''l'indicateur RSS, votre IP actuelle, la vitesse du réseau, la mémoire disponible et le nombre d'onglets'''.
Vous pouvez personnaliser la barre d'état en faisant un clic-droit dessus. [[image:menu_view11.png]]

;Barre latérale: Ouvre la barre latérale (à gauche) contenant '''la Recherche, l'Historique, les Dossiers, les Ressources, les Flux RSS''' ou les plugins de barre latérale.

;Taille du texte: Définit la taille du texte utilisée par Maxthon pour afficher les pages Web.

;Codage: Définit l'encodage de la page Web actuelle (à utiliser si la sélection automatique n'a pas fonctionné).

;Zoom: Zoom avant/arrière des pages pour une meilleure lecture. Vous pouvez utiliser Ctrl + '+' pour un zoom +20%, Ctrl + '-' pour un zoom -20% et Ctrl + '*' pour revenir à la taille originale.

;Aller à: Renvoie à la page précédente, suivante ou de démarrage.

;Arrêter Esc: Arrête le chargement de la page en cours.

;Actualiser F5: Actualise la page en cours.

;Verrouiller Alt + X: Verrouille l'onglet en cours. Un onglet Verrouillé ne sera pas fermé par "Fermer tout" ou "Fermer les autres". Une icône représentant un cadenas sera affichée sur l'onglet.
{| style="color:#FF6600; background:#FFF6E0; border: 1px solid #FF9900"
| [[image:tip.png]] Vous pouvez également faire un clic-droit sur l'onglet et sélectionner "Verrouiller l'onglet".
|}

;Arrêter ToutShift + Esc: Arrête le chargement de toutes les pages.

;Actualiser tout Shift + F5: Actualise toutes les pages.

;Source de la page: Affiche le code source de la page actuelle.

;Liste des liens de la page... Alt + L: Liste tous les liens de la page en cours dans un Popup. Vous pouvez filtrer, rechercher, télécharger les liens et bien plus encore.

;Plein écran F11: Bascule en mode plein écran, il ne reste que la barre latérale et celle des onglets (si affichée avant). Maintenant, vous avez plus d'espace disponible pour afficher les pages Web. Vous pouvez utiliser les mouvements de la souris pour naviguer facilement en mode plein écran. Vous pouvez faire réapparaître temporairement les menus et barres d'outils en déplaçant votre souris au sommet de l'écran.

<center> '''<''' [[Menu Edition]] | [[Menu Favoris]] '''>''' </center>

Menu Edition

2008-07-02T13:53:48Z

Ray1 :

[[image:menu_edit01.png]]

;Annuler fermer Alt + Z: Rouvre le dernier onglet fermé. Vous pouvez annuler la fermeture d'un onglet en utilisant cette fonction. La flèche en bout de ligne permet d'accéder à la liste des derniers onglets fermés, et de rouvrir directement l'un des derniers onglets fermés.

;Couper Ctrl + X: Coupe la sélection vers le presse papier.

;Copier Ctrl + C: Copie la sélection vers le presse papier.

;Coller Ctrl + V: Colle le contenu du presse papier à la position du curseur.

;Sélectionner tout Ctrl + A: Sélectionne la page entière.

;Rechercher (dans cette page)... Ctrl + F: Ouvre la boîte de dialogue de recherche.

;Editer: Edite la page ou le fichier en cours avec l'éditeur html par défaut défini dans 'Options > Options Internet > Programmes > Editeur HTML'

<center> '''<''' [[Menu Fichier]] | [[Menu Affichage]] '''>''' </center>

Menu Fichier

2008-07-02T13:51:57Z

Ray1 :

[[image:menu_file01.png]]

;Nouvelle Page Ctrl + N: Ouvre un nouvel onglet. Vous pouvez ouvrir une page vierge, votre page d'accueil, l'URL de la page en cours ou une URL à partir du presse-papier. Ceci ouvrira l'URL présente dans votre presse-papier.

{| style="color:#FF6600; background:#FFF6E0; border: 1px solid #FF9900"
| [[image:tip.png]] Vous pouvez également ouvrir un nouvel onglet avec les mouvements de la souris ou avec un double clic gauche sur la barre d'onglets.
|}

;Nouvelle session Maxthon: Ouvre une nouvelle instance de Maxthon. Vous pouvez désactiver cette option dans Options de Maxthon > Général > N'autoriser qu'une seule instance de Maxthon.

;Ouvrir... Ctrl + O: Affiche une boîte de dialogue pour vous permettre d'ouvrir ou de parcourir une adresse Web, un fichier ou un dossier. Maxthon l'ouvrira.

;Enregistrer sous... Ctrl + S: Enregistre la page Web en cours sous un autre nom ou avec une autre extension. Ceci enregistrera la page Web entièrement en utilisant les fonctions internes d'Internet Explorer. Il est recommandé d'utiliser la fonction 'Enregistrement rapide' pour enregistrer les pages Web.

;Enregistrer HTML uniquement... Alt + S: Enregistre la page Web en cours, mais uniquement la partie HTML (le texte). Ceci n'enregistrera pas les images ou les autres éléments.

;Enregistrement rapide: Enregistre rapidement la page Web en cours en incluant les images graphiques. Cette méthode est plus rapide que la fonction 'Enregistrer sous...' et elle doit mieux fonctionner sur plus de pages, même si elle fait la même chose.

;Enregistrement automatique Ctrl + Alt + S: Cette fonction enregistrera la page Web en cours dans le répertoire par défaut sans aucune boîte de dialogue ou message de confirmation. L'enregistrement automatique propose 4 options : la page Web est enregistrée au format HTML, au format MHT, au format HTML uniquement ou en enregistrement automatique. Vous pouvez modifier ces réglages dans le menu Options > Option de Maxthon > Enregistrement.

;Mise en page...: Ouvre une boîte de dialogue pour la mise en page (si vous voulez imprimer la page).

;Imprimer... Ctrl + P: Ouvre la boîte de dialogue standard d'impression de Windows.

;Aperçu avant impression...: Affiche la boîte de dialogue standard d'aperçu avant impression de la page en cours.

;Envoyer par e-mail: Envoie la page ou le lien en cours par e-mail.

;Importer/Exporter: Importe ou exporte les Favoris de Maxthon. Importe ou exporte également la liste des Proxy de Maxthon.

{| style="color:#FF0000; background:#FFF0F0; border: 1px solid #FF9999"
| [[image:warn.png]] Exporter les Favoris vers un format IE ne fonctionne pas avec Windows XP SP2 ! Vous devez utiliser le format de Maxthon.
|}

;Propriétés...: Affiche la boîte de dialogue des propriétés de la page en cours.

;Travailler hors connexion: Bascule Maxthon en mode hors connexion. Vous ne pourrez pas consulter de nouvelles pages avant de retourner en mode connecté.

;Fermer Ctrl + W: Ferme l'onglet en cours. Vous pouvez également double cliquer sur le titre de l'onglet actif dans la barre des onglets pour fermer la page Web en cours.

;Fermer tout Ctrl + Shift + W: Fermer tous les onglets ouverts.

;Fermer tout, sauf fenêtre courante: Ferme tous les onglets sauf l'onglet en cours.

;Stopper l'ouverture des onglets: Lors du chargement d'un groupe, vous pouvez stopper le chargement des éléments du groupe. Ceci n'arrête pas le chargement d'une page, mais seulement le chargement des nouveaux onglets.

;Cacher Alt + ' : Cache le programme complètement. Maxthon n'affichera plus son icône dans la barre des tâches ou dans la zone de notification. Appuyez sur la touche de nouveau pour afficher Maxthon. Vous pouvez modifier/activer la touche dans le menu Options > Options de Maxthon > Général > Activer la touche "Patron !"

;Quitter: Ferme Maxthon.

{| style="color:#FF6600; background:#FFF6E0; border: 1px solid #FF9900"
| [[image:tip.png]] Vous pouvez afficher ou supprimer la boîte de dialogue de confirmation dans le menu Options > Options de Maxthon > Avancé > Nécessite une confirmation en cochant Quitter le programme.
|}

<center> '''<''' [[Menus de Maxthon]] | [[Menu Edition]] '''>''' </center>

Les caractéristiques de Maxthon v2.0

2008-06-27T18:28:53Z

Ray1 :

Version: 2.0.2
Last Modified: 2006-05-03 2:34 PM

==Vue d'ensemble==
Ce document est une liste des modifications intervenues entre les versions 1.X et 2.X du navigateur Maxthon.


==Matrice des Fonctions==
{| class="wikitable" border="1" cellspacing="0" cellpadding="5" width="100%"
|-
! width="220" | Fonctions
! width="16" | 1.x
! width="16" | 2.x
!| Commentaires
|-
! colspan="4" | Généralités
|-

| Programme de Maxthon
|| [[image:16_alert.png|ALERT]]
|| [[image:16_info.png|INFO]]
|| Nous avons entièrement réécrit le programme de la version 2.0 de Maxthon pour la rendre plus stable et plus souple.
La structure modulaire peut libérer plus de ressources quand certaines fonctions ne sont pas activées, et rendre le logiciel plus extensible.
|-
| Système de compte d'utilisateur
|| [[image:16_error.png|ERROR]]
|| [[image:16_correct.png|YES]]
|| Les favoris et les préférences de l'utilisateur seront maintenant sauvegardés séparément, avec chiffrage.
Pour les utilisateurs qui ne veulent pas de ces dispositifs, une méthode anonyme d'ouverture est
cependant conservée.
|-
| Système de favoris
|| [[image:16_error.png|ERROR]]
|| [[image:16_correct.png|YES]]
|| La version 2.0 de Maxthon emploiera son propre
système de favoris.
Les nouveaux favoris seront beaucoup plus rapides qu'en utilisant le système de dossier des favoris des versions 1.X.
L'importation et l'exportation des favoris sont encore utilisables.
|-
| Groupes
|| [[image:16_correct.png|YES]]
|| [[image:16_error.png|ERROR]]
|| La fonction des groupes est incorporée au système des favoris de la version 2.0.
Vous pouvez choisir entre un Dossier ou un Groupe dans le menu contextuel sur un clic-droit de la souris.
|-
| Lecteur de Flux RSS
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
|| Le lecteur de flux RSS de la barre latérale est amélioré. Cette partie n'est cependant pas terminée
|-
| Favoris & Gestion des Flux
|| [[image:16_error.png|ERROR]]
|| [[image:16_correct.png|YES]]
|| Nouvelle fenêtre de gestion pour organiser les liens Favoris & les canaux des Flux.
|-
| Contrôle de l'adresse pour les Favoris
|| [[image:16_error.png|ERROR]]
|| [[image:16_correct.png|YES]]
|| Nouvelle fonction de contrôle de l'adresse dans le gestionnaire des Favoris
|-
| Post-it
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
|| Amélioration du programme. Cette partie n'est cependant pas terminée
|-
| Système des plugins
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
|| Amélioration du programme. Cette partie n'est cependant pas terminée
'''Neo101 a annoncé sur son site : http://www.neo101.nl/content/view/149/9/ qu'il avait en charge cette partie du programme.'''
|-
| Gestion des téléchargements
|| [[image:16_error.png|ERROR]]
|| [[image:16_correct.png|YES]]
|| Cette partie n'est cependant pas terminée
|-
! colspan="4" | Interface
|-
| Interface de lecture par onglets
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
|| '''''Je ne sais pas ce que cela recouvre''''' ; E. 
|-
| Interface entièrement personnalisable
|| [[image:16_alert.png|ALERT]]
|| [[image:16_correct.png|YES]]
|| L'interface de la version 2.0 sera plus souple que celle des versions 1.x
|-
| Support des 'Skins'
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
|| La prise en compte des Skins est bien meilleure dans la version 2.0 avec la prise en compte des images en format png.|Cette partie n'est cependant pas terminée
|-
| Sélection rapide dans une Base des Thèmes de Skins
|| [[image:16_error.png|ERROR]]
|| [[image:16_correct.png|YES]]
|| Les thèmes de Skins de la base sont visibles dans une interface d'Aperçu (non disponible pour tous les skins)
|-
| Support des diverses langues
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
|| Le menu de sélection de la langue a été déplacé vers le menu Affichage pour un meilleur accès.
|-
| Fenêtre compacte
|| [[image:16_error.png|ERROR]]
|| [[image:16_correct.png|YES]]
|| Vous pouvez cacher la barre de titre de la fenêtre principale.
Si une page personnalisée existe dans le skin que vous utilisez, la fenêtre apparaîtra avec le style personnalisé.
|-
| Modèle basé sur un composant UI
|| [[image:16_error.png|ERROR]]
|| [[image:16_correct.png|YES]]
||
* Options de Maxthon
* Page de démarrage de Maxthon
|-
| Barre de Recherche
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
|| Le surlignage & les boutons de mots-clés sont déplacés dans la barre de recherche dans la Page.
|-
| Barre des Favoris
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
|| "Ouvrir tous les liens" est déplacé dans le menu contextuel des dossiers (accessible par le clic-droit)
|-
| Outils externes
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
|| Les outils externes sont déplacés dans un bouton de la barre d'outils.
La barre d'outils peut être masquée par le menu Outils externes. Cette partie n'est cependant pas terminée
|-
| Barre des plugins
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
|| La barre des plugins est déplacée dans un bouton de la barre d'outils.
La barre d'outils peut être masquée par le menu Plugins. Cette partie n'est cependant pas terminée
|-
| Disposition d'un groupe d'onglets (au moins 2)
|| [[image:16_error.png|ERROR]]
|| [[image:16_correct.png|YES]]
|| Glisser/déplacer (avec le clic-gauche) à partir d'un onglet dans sa fenêtre permet de choisir une disposition Horizontale ou Verticale des onglets ouverts.
|-
| Boutons rapides sur la barre des onglets
|| [[image:16_error.png|ERROR]]
|| [[image:16_correct.png|YES]]
|| Facilite l'accès aux fonctions utilisées fréquemment :
* Afficher/cacher la barre latérale
* Gestion des onglets (Dynamique)
* Nouvel onglet (Dynamique)
* Afficher/cacher la barre d'outils des onglets
* Options de la barre des Onglets
|-
| Barre d'outils des Onglets
|| [[image:16_error.png|ERROR]]
|| [[image:16_correct.png|YES]]
|| Nouvelle barre d'outils sous la barre des Onglets.
Vous pouvez la personnaliser selon vos souhaits, ou la cacher.
|-
| Rechercher dans la Page
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
|| Nouvelle Barre d'outils : Rechercher dans la page
|-
| Personnalisation des informations de la Barre d'État
|| [[image:16_error.png|ERROR]]
|| [[image:16_correct.png|YES]]
|| État du trafic (entrant/sortant), de la vitesse, de la quantité de mémoire libre, etc.
|-
! colspan="4" | Navigation
|-
| Liste Annuler
|| [[image:16_alert.png|ALERT]]
|| [[image:16_correct.png|YES]]
|| Re-ouvrir les onglets récemment fermés.
La version 2.0 ajoute une base historique des onglets fermés.
|-
| Support du lecteur d'onglet
|| [[image:16_error.png|ERROR]]
|| [[image:16_correct.png|YES]]
|| Ouvre tous les liens d'un onglet dans un onglet cible
|-
| Contrôle du contenu de la page
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
|| Permettra le contrôle d'accès (par des règles) aux sites Web Cette partie n'est cependant pas terminée
|-
| Système des proxies
|| [[image:16_alert.png|ALERT]]
|| [[image:16_correct.png|YES]]
|| Le système des Proxies a été ré-écrit dans la version 2.0.
Il supporte les proxies HTTP, HTTPS, Socks4a, Socks5 avec authentification.
|-
| Règles avancées de proxies pour les sites Web
|| [[image:16_error.png|ERROR]]
|| [[image:16_correct.png|YES]]
|| Nouveau dans la version 2.0 Besoin d'amélioration de l'interface
|-
| Zoom de la Page
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
|| Nouveau contrôle UI dans la barre d'État
|-
| Super Glisser/déplacer
|| [[image:16_alert.png|ALERT]]
|| [[image:16_correct.png|YES]]
|| Ajout du glisser/déplacer dans la boîte de dialogue d'édition.
|-
| Mouvements de la souris
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
|| Les outils et la boîte de personnalisation ne sont pas terminés
|-
| Services Web "On the Go"
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
|| Ajout de la liste des services de mise à jour automatique à partir du serveur Web
|-
| Touche d'adresse
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
|| L'utilisation des touches F1 à F12 permet d'ouvrir les adresses affectées à ces touches.
|-
| Alias d'adresse
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
|| Pour affecter de courts noms à vos sites favoris (ex : pj pour pages jaunes) * '''Pas d'options sur l'onglet comme dans les versions 1.X''' En revanche, vous pouvez créer des alias en passant par les Options de Maxthon dans la partie Navigation [Ernest]
|-
| Complétement automatique des adresses
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
|| Ajout de nouvelles combinaisons de touches (pour -> .org, . gov)
|-
| Recherche rapide
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
|| Le serveur propose une liste supplémentaire de moteurs de recherche
|-
| Coller & Aller
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
|| Ajout d'une commande "Coller et Aller" dans menu contextuel de la Barre d'adresse (sur clic-droit de la souris) * Nota hors trad : il faut d'abord copier le raccourci du lien dans la page Web, puis aller dans la barre d'adresse et choisir sur clic droit l'option. L'adresse s'affiche et le site est ouvert.
|-
| URLs (Adresses) rapides
|| [[image:16_error.png|ERROR]]
|| [[image:16_correct.png|YES]]
|| Un répertoire d'adresses en ligne pour les personnes qui ne savent pas où surfer ...
|-
| Tueur de publicités
|| [[image:16_correct.png|YES]]
|| [[image:16_correct.png|YES]]
||
* Bloqueur de popup
* Filtre des Add ons d'IE
* Filtre de contenu avec support des expressions régulières
* Personnalisation des filtres de l'utilisateur
Le bloqueur des pubs flottantes est ôté et sera remplacé par un plugin. 
|}

<center>[[Base de connaissances de Maxthon 2.0]]</center>