AngelHerraez: example of inline format

2011-11-09T22:15:28Z

example of inline format

AngelHerraez: Jmol.php details moved to a new page

2011-10-19T20:06:48Z

Jmol.php details moved to a new page

New page

=Jmol.php: easy Jmol insertion into a web page=
You can insert a Jmol applet into a web page with nothing more than a simple <code><script></code> or <code><a></code> tag.
You don't have to install any Jmol files in your computer or web server.
You don't even need a file with the 3D model; it will be automatically obtained from an appropriate web server.

Note that this way of using Jmol is easily compatible with any environment where you do not control the full source code, like forums, blogs, wikis, content management systems, e-learning environments...
In fact, you can email the address and the recipient will see the Jmol applet by clicking on the received link.

If you invoke a PDB 4-character id, the model will be retrieved from the [http://www.pdb.org/ wwPDB (RCSB)]. If you invoke a chemical name, commercial name, SMILES string, InChI key, or CAS registry number, the model will be retrieved from the [http://cactus.nci.nih.gov/chemical/structure CACTVS server (NIH)].

==General syntax==
You must link to this page
http://chemapps.stolaf.edu/jmol/jmol.php
which does all the magic (a courtesy of Bob Hanson and the servers at St. Olaf College).
After that URL, text must be added to specify the molecule and some options. Such a text must follow the conventions for URIs, that is:
* first goes a <code>?</code> sign
* then, pairs of name=value
* if more than one name/value pair, they must be separated by an ampersand, <code>&</code> sign

==Common options==
One option among 1 to 3 is needed to define the molecule or model that will be displayed. The others are elective and affect the style of the applet or the model inside it.
# <code>source=</code>... the file source of a model, starting with <code>http://</code>
# <code>model=</code>... a name of a chemical, or SMILES string, InChI key, or CAS registry number.
# <code>pdbid=</code>... the 4-character ID of the model at the Protein Data Bank (RCSB, wwPDB).
* <code>inline</code> a return JavaScript to create the applet in the current page.
* <code>link=</code>... a text to make the hyperlink to a popup window.
* <code>script=</code>... a Jmol script (should be simple).
* <code>scriptvar=</code>... a previously defined JavaScript variable name or function (not the script itself; only with <code>inline</code>).
* <code>width=</code>... the width of the applet, either in pixels or in percent.
* <code>height=</code>... the height of the applet, either in pixels or in percent.
* <code>caption=</code>... a caption (only for the anchor type, not with <code>inline</code> and not with <code>link</code>).
* <code>title=</code>... a title (not with <code>inline</code>).

==Anchor format==
Creates a link to a new page with the model in Jmol.
(You can specify the target in the <code><a></code> tag, so that the page either replaces the current one or opens in a new window or tab in the browser)

==Popup format==
Creates a link to pop up a new window of a specified size, containing the Jmol applet with the model.

==Inline format==
Displays the Jmol applet inserted in the current page.

← Older revision		Revision as of 22:15, 9 November 2011
Line 41:		Line 41:
	==Inline format==		==Inline format==
	Displays the Jmol applet inserted in the current page.		Displays the Jmol applet inserted in the current page.
		+
		+	Example:
		+	<pre><script type="text/javascript"
		+	src="http://chemapps.stolaf.edu/jmol/jmol.php?model=acetone&inline">
		+	</script>
		+	</pre>

Jmol PHP - Revision history

AngelHerraez: example of inline format

AngelHerraez: Jmol.php details moved to a new page