File: README

package info (click to toggle)
mozilla-bonobo 0.4.2.1-5
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 2,452 kB
  • ctags: 147
  • sloc: sh: 8,602; ansic: 1,195; makefile: 52
file content (93 lines) | stat: -rw-r--r-- 3,053 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
What is it?
-----------

Mozilla-bonobo is a browser plugin. It "bridges" the browser to bonobo, the
GNOME component technology. It tries to support the Netscape 4 plugin API,
and it should work on many different browsers.

In short: this plugin makes your browser use bonobo controls to display
supported file types inside the browser window or frame.

*** This is alpha-quality software *** Use at your own risk ***

See the "Known Bugs" section below for trouble you might run into.

Browser compatibility
---------------------

- Mozilla (and mozilla-based browsers):
  resizing is broken on Gtk+ 2.0 based Mozilla - see mozilla bug #201158,
  but works fine on Gtk+ 1.2 based Mozilla.

- Netscape 4.8: 
  Currently not working

- Konqueror 3.1.1:
  resizing severely broken

- Opera 6.12 & 7.1 beta 1:
  does not work at all - StreamAsFile is never called I think.

Configurability
---------------

If you want the plugin to not support some mime type, you can
add that mime type to the list contained in the GConf key
/apps/mozilla-bonobo/mime-types/ignore. Items in this list may
contain the wildcards "*" and "?", so if you don't want any
video files to be handled, add "video/*", for example.

To get mozilla to respect your new GConf settings, you need
to get it to flush its mime type cache. The easiest way to
achieve this is to delete your $HOME/.mozilla/pluginreg.dat
and to restart mozilla.

There's currently no easy way for this to happen automatically,
because mozilla caches these mime types very aggressively.
Please see (and vote for!) mozilla bug #125469.

Building
--------

You need development packages for some GNOME libraries that are used
(bonobo, bonoboui, gnome-vfs and so on) and for mozilla.

You need to give one mandatory parameter to "configure":
--with-plugin-install-dir=/path/to/mozilla/plugin/directory

Interaction of Bonobo Components with the Browser
-------------------------------------------------

This example shows how a component can redirect the browser to another URL.

On startup, the component needs to create a BonoboEventSource:

   BonoboEventSource* evs = bonobo_event_source_new();
   bonobo_object_add_interface((BonoboObject*)control, (BonoboObject*)evs);

To redirect the browser, an event should be sent from the event source
like this:

   BonoboArg* arg = bonobo_arg_new(BONOBO_ARG_STRING);
   BONOBO_ARG_SET_STRING(arg, "http://www.gnome.org");
   bonobo_event_source_notify_listeners (evs, "URL", arg, NULL);

The "http://www.gnome.org" string is where the actual URL should be inserted.
Note that javascript code can be executed through the same mechanism.
As an example, the following URL would display a message box:
   "javascript:alert('hello world.')"

Known Bugs
----------

- Resizing is broken on Gtk+ 2.0 based Mozilla. See mozilla bug #201158.
  It actually works fine on Gtk+ 1.2 based Mozilla.

- Many many more...

Hacking
-------

If you checked out the CVS version, be sure to have automake 1.6.
mozilla-bonobo uses target specific CFLAGS, and those don't work
with 1.4.