Template:Drugbox/doc
This is a documentation subpage for Template:Drugbox It contains usage information, categories and other content that is not part of the original template page. |
This template employs intricate features of template syntax. You are encouraged to familiarize yourself with its setup and parser functions before editing the template. If your edit causes unexpected problems, please undo it quickly. Remember that you can conduct experiments, and should test all improvements, in either the general template sandbox or your user space before changing anything here. |
The Template:Drugbox allows a consistent interface to other sources that provide information about a drug, fixed drug-combinations, vaccines or monoclonal antibody drugs. Don't worry about trying to fill in all the fields -- even specifying just one or two can still be useful. This template now allows for combination products (see #Combination products), monoclonal antibody (see #Monoclonal antibody drug) and vaccine products (see #Vaccine product).
Single chemical drugs
editWhile editing a drug page, copy and paste either style of the following text at the top of the page:
Shortened single-drug form: (For visibility, vertical-bar pipes "|" start a line but can also end a line.)
{{Drugbox | IUPAC_name = | image = | alt = | CAS_number = | ATCvet = | ATC_prefix = <!-- 'none' if uncategorised --> | ATC_suffix = | PubChem = | DrugBank = | chemical_formula = | molecular_weight = | bioavailability = | protein_bound = | metabolism = | elimination_half-life = | excretion = | pregnancy_AU = <!-- A / B1 / B2 / B3 / C / D / X --> | pregnancy_US = <!-- A / B / C / D / X --> | pregnancy_category= | legal_AU = <!-- S2, S3, S4, S5, S6, S7, S8, S9 or Unscheduled—> | legal_BR = <!-- OTC, A1, A2, A3, B1, B2, C1, C2, C3, C4, C5, D1, D2, E, F--> | legal_CA = <!-- Schedule I, II, III, IV, V, VI, VII, VIII --> | legal_UK = <!-- GSL, P, POM, CD, or Class A, B, C --> | legal_US = <!-- OTC / Rx-only / Schedule I, II, III, IV, V --> | legal_status = | routes_of_administration = }}
Full single-drug template with extended fields:
{{Drugbox | IUPAC_name = | image = | width = | alt = | image2 = | width2 = | alt2 = | imagename = <!-- else may use drug_name --> | drug_name = <!-- else may use imagename --> | CAS_number = | CAS_supplemental = | ATCvet = | ATC_prefix = <!-- 'none' if uncategorised --> | ATC_suffix = | ATC_supplemental = | PubChem = | DrugBank = | ChemSpiderID = | chemical_formula = | C= | H= | Ag= | As= | Au= | B= | Bi= | Br= | Cl= | Co= | F= | Gd= | I= | K= | Mn= | N= | Na= | O= | P= | Pt= | S= | Sb= | Se= | Sr= | Tc= | Zn= | charge= | molecular_weight = | smiles = | synonyms = | density = | melting_point = | melting_high = | melting_notes = | boiling_point = | boiling_notes = | solubility = | specific_rotation = | sec_combustion = | bioavailability = | protein_bound = | metabolism = | elimination_half-life = | excretion = | licence_EU = <!-- EMEA requires brand name --> | licence_US = <!-- FDA may use generic name --> | DailyMedID = <!-- preference to licence_US --> | pregnancy_AU = <!-- A / B1 / B2 / B3 / C / D / X --> | pregnancy_US = <!-- A / B / C / D / X --> | pregnancy_category= | legal_AU = <!-- S2, S3, S4, S5, S6, S7, S8, S9 or Unscheduled—> | legal_BR = <!-- OTC, A1, A2, A3, B1, B2, C1, C2, C3, C4, C5, D1, D2, E, F--> | legal_CA = <!-- Schedule I, II, III, IV, V, VI, VII, VIII --> | legal_UK = <!-- GSL, P, POM, CD, or Class A, B, C --> | legal_US = <!-- OTC / Rx-only / Schedule I, II, III, IV, V --> | legal_status = | dependency_liability = | routes_of_administration = }}
OR Alternatively: use Diberri's excellent Wikipedia template filling tool which will generate a populated template to copy & paste into an article if given a DrugBank ID number (which may be obtained from DrugBank search). Please select for Fill template vertically, but as Wikipedia is a general encyclopedia, most drugs do not warrant Show extended fields.
Combination products
editThis uses a different subset of parameters, defining the parameter type=combo. Generally combination articles will not need display the molecular images of its constituents (the relevant specific articles would have the images). It disables all Chemical & Pharmacology parameters (which describe properties of single drug items). These redundant disabled parameters are best not included in the template calling, so use the following abridged forms of the template:
Shortened combination product form:
{{Drugbox | type = combo | component1 = <!-- Drugname, automatically linked --> | class1 = <!-- Group, manual link using [[..|..]] --> | component2 = <!-- Drugname, automatically linked --> | class2 = <!-- Group, manual link using [[..|..]] --> | CAS_number = | ATCvet = | ATC_prefix = <!-- 'none' if uncategorised --> | ATC_suffix = | PubChem = | DrugBank = | pregnancy_AU = <!-- A / B1 / B2 / B3 / C / D / X --> | pregnancy_US = <!-- A / B / C / D / X --> | pregnancy_category= | legal_AU = <!-- S2, S3, S4, S5, S6, S7, S8, S9 or Unscheduled—> | legal_BR = <!-- OTC, A1, A2, A3, B1, B2, C1, C2, C3, C4, C5, D1, D2, E, F--> | legal_CA = <!-- Schedule I, II, III, IV, V, VI, VII, VIII --> | legal_UK = <!-- GSL, P, POM, CD, or Class A, B, C --> | legal_US = <!-- OTC / Rx-only / Schedule I, II, III, IV, V --> | legal_status = | routes_of_administration = }}
Full combination product template with extended fields and allowing for up to 4 items:
{{Drugbox | type = combo | drug_name = | component1 = <!-- Drugname, automatically linked --> | class1 = <!-- Group, manual link using [[..|..]] --> | component2 = <!-- Drugname, automatically linked --> | class2 = <!-- Group, manual link using [[..|..]] --> | component3 = <!-- Drugname, automatically linked --> | class3 = <!-- Group, manual link using [[..|..]] --> | component4 = <!-- Drugname, automatically linked --> | class4 = <!-- Group, manual link using [[..|..]] --> | CAS_number = | CAS_supplemental = | ATCvet = | ATC_prefix = <!-- 'none' if uncategorised --> | ATC_suffix = | ATC_supplemental = | PubChem = | DrugBank = | ChemSpiderID = | licence_EU = <!-- EMEA requires brand name --> | licence_US = <!-- FDA may use generic name --> | DailyMedID = <!-- preference to licence_US --> | pregnancy_AU = <!-- A / B1 / B2 / B3 / C / D / X --> | pregnancy_US = <!-- A / B / C / D / X --> | pregnancy_category= | legal_AU = <!-- S2, S3, S4, S5, S6, S7, S8, S9 or Unscheduled—> | legal_BR = <!-- OTC, A1, A2, A3, B1, B2, C1, C2, C3, C4, C5, D1, D2, E, F--> | legal_CA = <!-- Schedule I, II, III, IV, V, VI, VII, VIII --> | legal_UK = <!-- GSL, P, POM, CD, or Class A, B, C --> | legal_US = <!-- OTC / Rx-only / Schedule I, II, III, IV, V --> | legal_status = | dependency_liability = | routes_of_administration = }}
Note that for drug-combinations at least two components must be defined, with optional 3rd or 4th components. For each component:
- define its name (which will be automatically wikilinked)
- and the class of agent it belongs to but this usually needs manual wikilinking, e.g. for Seretide:
Seretide
| |
Combination of | |
w:Fluticasone | Glucocorticoid |
w:Salmeterol | Long-Acting Beta2 Agonist |
Identifiers | |
CAS number | ? |
ATC code | ? |
PubChem | ? |
Therapeutic considerations | |
Pregnancy cat. |
? |
Legal status | |
Routes | ? |
| type = combo | drug_name = Seretide | component1 = Fluticasone | class1 = [[w:Glucocorticoids |Glucocorticoid]] | component2 = Salmeterol | class2 = [[w:Beta2-adrenergic receptor agonist|Long-Acting Beta2 Agonist]]
Monoclonal antibody drugs
editThis uses a different subset of parameters, defining the parameter type=mab. This allows the alternative parameter of the derived source and target of action to be specified. The MAB name has appended after it a "?" linked to Nomenclature of monoclonal antibodies, saving on the need explain how each MAB has been named.
Shortened Monoclonal antibody form:
{{Drugbox | type = mab | image = | alt = | source = <!-- organism from which derived --> | target = <!-- antigen --> | CAS_number = | ATC_prefix = <!-- 'none' if uncategorised --> | ATC_suffix = | PubChem = | DrugBank = | chemical_formula = | molecular_weight = | bioavailability = | protein_bound = | metabolism = | elimination_half-life = | excretion = | pregnancy_AU = <!-- A / B1 / B2 / B3 / C / D / X --> | pregnancy_US = <!-- A / B / C / D / X --> | pregnancy_category= | legal_AU = <!-- S2, S3, S4, S5, S6, S7, S8, S9 or Unscheduled—> | legal_BR = <!-- OTC, A1, A2, A3, B1, B2, C1, C2, C3, C4, C5, D1, D2, E, F--> | legal_CA = <!-- Schedule I, II, III, IV, V, VI, VII, VIII --> | legal_UK = <!-- GSL, P, POM, CD, or Class A, B, C --> | legal_US = <!-- OTC / Rx-only / Schedule I, II, III, IV, V --> | legal_status = | routes_of_administration = }}
Full Monoclonal antibody template with extended fields:
{{Drugbox | type = mab | image = | width = | alt = | image2 = | width2 = | alt2 = | imagename = <!-- else may use drug_name --> | drug_name = <!-- else may use imagename --> | source = <!-- organism from which derived --> | target = <!-- antigen --> | CAS_number = | CAS_supplemental = | ATCvet = | ATC_prefix = <!-- 'none' if uncategorised --> | ATC_suffix = | ATC_supplemental = | PubChem = | DrugBank = | ChemSpiderID = | chemical_formula = | C= | H= | Ag= | As= | Au= | B= | Bi= | Br= | Cl= | Co= | F= | Gd= | I= | K= | Mn= | N= | Na= | O= | P= | Pt= | S= | Sb= | Se= | Sr= | Tc= | Zn= | charge= | molecular_weight = | smiles = | synonyms = | density = | melting_point = | melting_high = | melting_notes = | boiling_point = | boiling_notes = | solubility = | specific_rotation = | sec_combustion = | bioavailability = | protein_bound = | metabolism = | elimination_half-life = | excretion = | licence_EU = <!-- EMEA requires brand name --> | licence_US = <!-- FDA may use generic name --> | DailyMedID = <!-- preference to licence_US --> | pregnancy_AU = <!-- A / B1 / B2 / B3 / C / D / X --> | pregnancy_US = <!-- A / B / C / D / X --> | pregnancy_category= | legal_AU = <!-- S2, S3, S4, S5, S6, S7, S8, S9 or Unscheduled—> | legal_BR = <!-- OTC, A1, A2, A3, B1, B2, C1, C2, C3, C4, C5, D1, D2, E, F--> | legal_CA = <!-- Schedule I, II, III, IV, V, VI, VII, VIII --> | legal_UK = <!-- GSL, P, POM, CD, or Class A, B, C --> | legal_US = <!-- OTC / Rx-only / Schedule I, II, III, IV, V --> | legal_status = | dependency_liability = | routes_of_administration = }}
Vaccines
editThis uses a different subset of parameters, defining the parameter type=vaccine. This allows the alternative parameters of the vaccine_type and target to be specified:
- target is freetext. Usually will be wikified by the editor to point to a specific page
- vaccine_type must be from the defined list of options as described at w:Vaccine#Type, the infobox will provide standardised display and links as follows:
vaccine_type value Output killed or inactivated Killed/Inactivated attenuated Attenuated virus live Live bacteria toxoid Toxoid protein or protein subunit Protein subunit subunit Subunit conjugate Conjugate vaccine recombinant Recombinant Vector DNA DNA vaccination
Where a vaccination product protects against more than one agent, please use the combination form of this infobox with type=combo (per #Combination products), and each classX=[[w:Vaccine|]].
Shortened Vaccine form:
{{Drugbox | type = vaccine | image = | alt = | target = <!-- the antigen/bacteria/toxin/virus to protect against --> | vaccine_type = <!-- killed/attenuated/live/toxoid/protein subunit/subunit/conjugate/recombinant/DNA --> | CAS_number = | ATCvet = | ATC_prefix = <!-- 'none' if uncategorised --> | ATC_suffix = | PubChem = | DrugBank = | pregnancy_AU = <!-- A / B1 / B2 / B3 / C / D / X --> | pregnancy_US = <!-- A / B / C / D / X --> | pregnancy_category= | legal_AU = <!-- S2, S3, S4, S5, S6, S7, S8, S9 or Unscheduled—> | legal_BR = <!-- OTC, A1, A2, A3, B1, B2, C1, C2, C3, C4, C5, D1, D2, E, F--> | legal_CA = <!-- Schedule I, II, III, IV, V, VI, VII, VIII --> | legal_UK = <!-- GSL, P, POM, CD, or Class A, B, C --> | legal_US = <!-- OTC / Rx-only / Schedule I, II, III, IV, V --> | legal_status = | routes_of_administration = }}
Full Vaccine template with extended fields:
{{Drugbox | type = vaccine | image = | alt = | width = | image2 = | alt2 = | width2 = | imagename = <!-- else may use drug_name --> | drug_name = <!-- else may use imagename --> | target = <!-- the antigen/bacteria/toxin/virus to protect against --> | vaccine_type = <!-- killed/attenuated/live/toxoid/protein subunit/subunit/conjugate/recombinant/DNA --> | CAS_number = | CAS_supplemental = | ATCvet = | ATC_prefix = <!-- 'none' if uncategorised --> | ATC_suffix = | ATC_supplemental = | PubChem = | DrugBank = | ChemSpiderID = | licence_EU = <!-- EMEA requires brand name --> | licence_US = <!-- FDA may use generic name --> | DailyMedID = <!-- preference to licence_US --> | pregnancy_AU = <!-- A / B1 / B2 / B3 / C / D / X --> | pregnancy_US = <!-- A / B / C / D / X --> | pregnancy_category= | legal_AU = <!-- S2, S3, S4, S5, S6, S7, S8, S9 or Unscheduled—> | legal_BR = <!-- OTC, A1, A2, A3, B1, B2, C1, C2, C3, C4, C5, D1, D2, E, F--> | legal_CA = <!-- Schedule I, II, III, IV, V, VI, VII, VIII --> | legal_UK = <!-- GSL, P, POM, CD, or Class A, B, C --> | legal_US = <!-- OTC / Rx-only / Schedule I, II, III, IV, V --> | legal_status = | dependency_liability = | routes_of_administration = }}
General notes about the fields
editNone of the fields are obligatory. DrugBank does not include every known drug and likewise Protein Binding may not be applicable to the drug (e.g. if only ever applied externally), so if these fields are not defined then their row is not shown.
Don't worry about getting all the fields -- just do your best, and if you have any questions or suggestions, feel free to ask at Template talk:Drugbox.
Image
editYou can use the image to provide an illustration. These fields are optional, but it is helpful to provide an image if you can find one. Of course most images on the internet are copyrighted.
You may specify the image name directly, else the template defaults to trying to use PAGENAME (the name of the drug article being written).
The alt parameter specifies the alt text for the image, used by visually impaired readers. See WP:ALT
There is also an optional width parameter you can add for the image. If your picture is far too big, then add a new line and specify a custom width like this:
| image = Aspirin.png | width = 325
When no width parameter is specified, it defaults to a width of 220.
Occasionally a second image might be added to show the chemical structure in a different format. Use the optional image2 parameter for this. Hence the Paracetamol article uses:
| image = Paracetamol-skeletal.png | image2 = Paracetamol-3D.png
An alt2 parameter specifies the alt text for the second image. image2 generally uses the same width settings as the first image, i.e. as defined by width otherwise a default value of 220. A specific width2 may though be applied.
ATC, ATCvet and CAS
editWhere the drug is not included in ATC coding system (as opposed to its value just not been entered into the template) then set ATC_prefix to 'none':
| ATC_prefix = none
Additional ATC or CAS codes may be included with the optional ATC_supplemental & CAS_supplement parameter as a comma-separated lists. CAS or ATC templates may be used to have these additional codes link to the relevant databases:
| CAS_supplemental ={{CAS|427-51-0}} (acetate) | ATC_supplemental ={{ATC|M02|AA15}}, {{ATC|S01|BC03}}
Adds the following linked codes:
For CAS - 427-51-0 (acetate) For ATC - M02 , S01
Veterinary drugs are placed in a slightly different classification system, ATCvet. The code may be specified as ATCvet by setting the parameter ATCvet to 'yes'. Do not include the leading 'Q' in ATC_prefix:
| ATCvet = yes | ATC_prefix = N05 | ATC_suffix = AX90
Dependence liability
editAn optional parameter of Dependence liability allows opioids or benzodiazepines to be flagged with the risk of becoming dependent upon them, although in many cases this may be somewhat subjective. Drugs should be rated as Low, Medium, High or Extremely High:
| dependency_liability=High
Physical properties
editAdditional optional physical proprerties are for Melting point, Boiling point, Specific rotation and Standard enthalpy change of combustion
| melting_point = | boiling_point = | specific_rotation= | sec_combustion =
Chemical formula
editYou can provide the chemical formula as either the default
| chemical_formula =
or by setting atom counts for each element, in these parameters:
| C= | H= | Ag= | As= | Au= | B= | Bi= | Br= | Cl= | Co= | F= | Gd= | I= | K= | Mn= | N= | Na= | O= | P= | Pt= | S= | Sb= | Se= | Sr= | Tc= | Zn= | charge=
e.g. | C=2 | H=6 | O=1 gives Formula C2H6O
Irrespective of the order of assigning values to the constituent parameters, the formula is displayed with elements in the above order. The charge parameter, if defined, is shown superscripted.
e.g. | C=2 | O=1 | H=6 | charge=+ is identical to next line | C=2 | H=6 | O=1 | charge=+ giving Formula C2H6O+
Licensing information
editThere are two major licensing authorities that make drug information easily accessible: The US Food and Drug Administration (FDA) and the European Medicines Agency (EMEA). NB The word "Licence" is the noun in British English, "License" is the verb.
The FDA "Label Information" and the EMEA "Product Information", where available, are very detailed. There is material aimed at the professional and also plain-English consumer information. These are excellent reliable source for article information but also contains much that makes it a worthwhile "External link" since there is no way one can include all the info. Both sites work using of the brand name of the drug but the FDA site also allows searches with the generic name (active ingredient), which lists generic variants where they are licensed.
| licence_EU = <!-- EMEA requires brand name --> | licence_US = <!-- FDA may use generic name -->
Lists of products and the parameter term to use may be easily searched for:
- European Public Assessment Reports SiteMap. Authorised Products: EMEA A-F, EMEA G-L, EMEA M-R, EMEA S-Z
- When items are composed of more than one word, licence_EU uses adjoined words (i.e. no spaces); e.g. infanrixpenta for Infanrix Penta.
- Drugs@FDA Search by Drug Name or Active Ingredient
- Where items are composed of more than one word, licence_US requires an underscore '_' in place of any spaces; e.g. Acyclovir_Sodium.
More patient friendly than the FDA's pages is Daily Med which reproduces the same details. The DailyMedID parameter, where specified, is shown in preference to the licence_US direct FDA link. Daily Med entries may be located at Search By Drug Name, e.g. for Furosemide
| DailyMedID = 3940
Legal status
editLegal status has been previously declared using just the legal_status parameter with a variety of markup styles used to indicate various countries and their classifications. Alternatively legal_AU, legal_BR, legal_CA, legal_UK and legal_US may be set to the fixed options in the table below. The template will ensure the categorisation is shown correctly capitalised, use Unicode Rx symbol and add a linked 2-letter country code as per WP:MOS. legal_status may still be used with the country-specific parameters as it is appended afterwards, allowing backwards compatibility for articles that only define this parameter, or for the future with free-text of other information.
Hence | legal_AU = S2 | legal_BR = OTC | legal_UK = gsl | legal_US = Rx-only | legal_status = Not marketed in Asia
Gives S2(AU) A1(BR) POM(UK) ℞-only(US) Not marketed in Asia
Note: if a drug is restricted everywhere to prescription-only, please set legal_status = Rx-only rather than similarly define for each and every country ('Rx-only' is specifically recognised by legal_status and shows as ℞ Prescription only)
Abbreviation (options) |
Meaning |
---|---|
legal_status | Anywhere |
Rx-only | ℞ Prescription only |
legal_AU | Australia (see SUSDP) |
Unscheduled | Unscheduled/exempt |
S2 | Schedule 2 Pharmacy Medicine |
S3 | Schedule 3 Pharmacist Only Medicine |
S4 | Schedule 4 Prescription Only Medicine |
S5 | Schedule 5 Caution |
S6 | Schedule 6 Poison |
S7 | Schedule 7 Dangerous Poison |
S8 | Schedule 8 Controlled Drug |
S9 | Schedule 9 Prohibited Substance |
legal_BR | Brazil (see Controlled Drugs and Substances Act) |
OTC | Over the counter |
A1 | Class A1: Narcotic Drugs |
A2 | Class A2: Narcotic Drugs |
A3 | Class A3: Psychoactive Drugs |
B1 | Class B1: Psychoactive Drugs |
B2 | Class B2: Anorectic Drugs |
C1 | Class C1: Other controlled substances |
C2 | Class C2: Retinoids |
C3 | Class C3: Immunosuppressive Drugs |
C4 | Class C4: Antiretroviral Drugs |
C5 | Class C5: Anabolic steroids |
D1 | Class D1: Drug precursors |
D2 | Class D2: Drug precursors |
E | Class E: Controlled plants |
F | Class F: Prohibited Substances |
legal_CA | Canada |
? | Over the counter |
? | Prescription only. Where known may specify: |
Schedule I | see Controlled Drugs and Substances Act |
Schedule II | |
Schedule III | |
Schedule IV | |
Schedule V | |
Schedule VI | |
Schedule VII | |
Schedule VIII | |
legal_UK | United Kingdom |
GSL | General Sale List |
P | Pharmacy Medicine |
POM | Prescription Only Medicine |
CD | Controlled Drug. Where known may specify: |
Class A | see Misuse of Drugs Act 1971 |
Class B | |
Class C | |
legal_US | United States |
OTC | Over the counter |
℞-only Rx-only |
Prescription only. Where known may specify: |
Schedule I | see Controlled Substances Act |
Schedule II | |
Schedule III | |
Schedule IV | |
Schedule V |
Pregnancy category
editPregnancy Categorisation has been previously declared using just the pregnancy_category parameter with a variety of markup styles used to indicate various countries and their classifications. Alternatively pregnancy_AU and pregnancy_US may be set to the fixed categories. For Australia values permitted are: A, B1, B2, B3, C, D or X (note if just set to 'B' then B? is shown). For US values permitted are: A, B, C, D or X.
Note the UK does not have official designated categorisations, but has both a variety of standard phrases with explanatory qualifications, plus many individual descriptions. pregnancy_category may still be used with the country-specific parameters as it is appended afterwards, allowing backwards compatibility for articles that only define this parameter, or for the future with free-text of other information.
Hence | pregnancy_AU = B1 | pregnancy_US = C | pregnancy_category = Used in pregnancy for [[w:Pregnancy-induced hypertension|PIH]]
Gives B1(AU) C(US) Used in pregnancy for PIH
Chemical data
editOptional additional chemical data fields of SMILES and Synonyms are for most drugs not helpful to the wider readership.
| smiles = | synonyms =
Physical data
editThis is an entirely optional section, and for most drugs is not helpful to the wider readership. Only include if information of particular interest for the drug as to its chemical propersites (e.g. in its manufacture or as an important chemical in its own right, e.g. Aspirin). If any of the following optional parameters are defined then a new section header of 'Physical data' is shown.
| density = | melting_point = | boiling_point = | solubility = | specific_rotation = | sec_combustion =
The template will add the following to the numeric values provided:
- Density - added 'g/cm3'
- Melting or Boiling points - added '°C' along with calculated converted value in °F.
- Solubility - added 'mg/mL (20°C)'
Hence: | melting_point = 100 gives: Melting point 100°C (212°F)
In addition, where the melting point occurs over a range of temperatures, use melting_high for the upper value.
Hence: | melting_point = 100 | melting_high = 104 gives: Melting point 100-104 °C (212-219 °F)
Comments can be added to the melting and boiling point entries using melting_notes and boiling_notes
Hence: | boiling_point = 100 | boiling_notes = (sublimes) gives: Boiling point 100 °C (212 °F) (sublimes)
See also
edit- WP:PHARM for wikiproject page