Versions Compared

Old Version 13

changes.mady.by.user Andrew Bredenkamp

Saved on

compared with

New Version Current

changes.mady.by.user Andrew Bredenkamp

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

 

Documentation to do:

Tooltips

HTML

Unique content types

Region: domestic vs international

Uploading images - allow access unrestricted

How to find the asset id of a page

Shared blocks

 

JSON structures

content-plain

Default content type. Used in most standard cases. Provides a Heading and content block underneath.

Code Block
{
    "contentType": "content-plain",
    "heading": "Text here",
    "content": "Text here."
}

 

content-plain-images-triplecrown

 

used specifically for content to display the triple crown association images. Normally uses a shared object, but sometimes has some variation.

 

Either use the block below, or link the asset 342525 in the appropriate place.

 

Code Block
{
	"heading"     : "International recognition",
	"contentType" : "content-plain-images-triplecrown",
	"content"     : "Victoria's MBA programme is accredited to the British-based <a href='http://www.mbaworld.com/'>Association of MBAs (AMBA)</a>, an internationally recognised global standard for all MBA programmes.\nVictoria Business School is also one of just 75 business schools worldwide that hold the 'Triple Crown' of international business education accreditations. You can be confident your degree will stand up against the best around the world.\n<a href='http://www.victoria.ac.nz/vbs/about/welcome/accreditation'>Find out more about accreditations and what they mean for you.</a>",
	"images"      : [{
		"imageAssetId" : "340052",
		"imageSrc"     : "%globals_asset_url:340052^json_encode%",
		"altText"      : "EQUIS Logo",
		"linkTitle"    : "",
		"link"         : "",
		"linkUrl": ""
	}, {
		"imageAssetId" : "340057",
		"imageSrc"     : "%globals_asset_url:340057^json_encode%",
		"altText"      : "AMBA Logo",
		"linkTitle"    : "",
		"link"         : "",
		"linkUrl"      : ""
	}, {
		"imageAssetId" : "340058",
		"imageSrc"     : "%globals_asset_url:340058^json_encode%",
		"altText"      : "AASCB Logo",
		"linkTitle"    : "",
		"link"         : "",
		"linkUrl"      : ""
	}]
}

 

 

content-plain-links

 

Similar to the content-plain object, but allows buttons for linking. We try and use this where possible instead of using inline links.

 

An important distinction between "links" and "externalLinks" - Graphically, "links" will be displayed with a big blue button, while "externalLinks" will display a bullet list of links with an 'external link' symbol next to it - Image Removed

 

 

 

...

Table of Contents

For information on other aspects of study areas, degrees and postgraduate:

See page

/wiki/spaces/TD/pages/88277761


Documentation to do:

Tooltips

HTML

Unique content types

Region: domestic vs international

Uploading images - allow access unrestricted

How to find the asset id of a page

Shared blocks


JSON structures

content-plain

Default content type. Used in most standard cases. Provides a Heading and content block underneath.

Code Block
{
    "contentType": "content-plain",
    "heading": "Text here",
    "content": "Text here."
}

 

content-plain-images-triplecrown

 

used specifically for content to display the triple crown association images. Normally uses a shared object, but sometimes has some variation.

 

Either use the block below, or link the asset 342525 in the appropriate place.

 

Code Block
{
	"heading"     : "International recognition",
	"contentType" : "content-plain-images-triplecrown",
	"content"     : "Victoria's MBA programme is accredited to the British-based <a href='http://www.mbaworld.com/'>Association of MBAs (AMBA)</a>, an internationally recognised global standard for all MBA programmes.\nVictoria Business School is also one of just 75 business schools worldwide that hold the 'Triple Crown' of international business education accreditations. You can be confident your degree will stand up against the best around the world.\n<a href='http://www.victoria.ac.nz/vbs/about/welcome/accreditation'>Find out more about accreditations and what they mean for you.</a>",
	"images"      : [{
		"imageAssetId" : "340052",
		"imageSrc"     : "%globals_asset_url:340052^json_encode%",
		"altText"      : "EQUIS Logo",
		"linkTitle"    : "",
		"link"         : "",
		"linkUrl": ""
	}, {
		"imageAssetId" : "340057",
		"imageSrc"     : "%globals_asset_url:340057^json_encode%",
		"altText"      : "AMBA Logo",
		"linkTitle"    : "",
		"link"         : "",
		"linkUrl"      : ""
	}, {
		"imageAssetId" : "340058",
		"imageSrc"     : "%globals_asset_url:340058^json_encode%",
		"altText"      : "AASCB Logo",
		"linkTitle"    : "",
		"link"         : "",
		"linkUrl"      : ""
	}]
}

 


 

content-plain-links

 

Similar to the content-plain object, but allows buttons for linking. We try and use this where possible instead of using inline links.

 

An important distinction between "links" and "externalLinks" - Graphically, "links" will be displayed with a big blue button, while "externalLinks" will display a bullet list of links with an 'external link' symbol next to it - Image Added

 


 

Code Block
{
   "contentType" : "content-plain-links",
   "heading"     : "",
   "content"     : "",
    "links"       : [
        {
            "linkText"  :"Text",
            "linkTitle" :"Text",
            "link"      :"%globals_asset_url:ASSETID^json_encode%"
        }
   ],
	"externalLinks": [{
		"linkText"   : "Text",
		"linkTitle"  : "Text",
		"link"       : "http://www.careers.govt.nz/"

	}]
}

 



 

content-facts

 

This is used exclusively on the degree-about pages. They supply the data for the "Level of study", "Length of full-time study", and "Useful secondary school subjects" contents.

 

This block does not change here. If these values are to change, they need to be done in the metadata of the degree. If this block changes from what is contained here it will most likely break things. Please don't do that... :(

 

Code Block
{
    "contentType" : "content-facts",
    "heading"     : "",
    "content"     : {
        "levelOfStudy": {
            "contentType" : "levelOfStudy",
            "heading"     : "%asset_metadata_ProgrammeId^as_asset:asset_metadata_postOrUndergradHeading^json_encode%",
            "content"     : "%asset_metadata_ProgrammeId^as_asset:asset_metadata_postOrUndergrad^json_encode%"
        },
        "studyLength": {
            "contentType" : "studyLength",
            "heading"     : "%asset_metadata_ProgrammeId^as_asset:asset_metadata_LengthOfFulltimeStudyHeading^json_encode%",
            "content"     : "%asset_metadata_ProgrammeId^as_asset:asset_metadata_LengthOfFulltimeStudy^json_encode%",
            "contentSub" : "%asset_metadata_ProgrammeId^as_asset:asset_metadata_LengthOfFulltimeStudySubHeading^json_encode%"
        },
        "fees": {
            "contentType" : "fees",
            "heading"     : "%asset_metadata_ProgrammeId^as_asset:asset_metadata_CourseFeesHeadingOverride^json_encode%",
            "content"     : "%asset_metadata_ProgrammeId^as_asset:asset_metadata_EstimatedYearlyCourseFees^json_encode%"
        },
        "usefulSubjects": {
            "contentType" : "usefulSubjects",
            "heading"     : "%asset_metadata_ProgrammeId^as_asset:asset_metadata_UsefulSecondarySchoolSubjectsHeading^json_encode%",
            "content"     : "%asset_metadata_ProgrammeId^as_asset:asset_metadata_UsefulSecondarySchoolSubjects^json_encode%"
        }
    }
}

 

course-examples

On a study-area subject page. To display the example courses in a different spot (normally they are automatically added at the end of the subject), insert the following json object

Code Block
{ "contentType": "course-examples" }


entry-requirements

Used exclusively on the degree-requirement pages. Used for displaying the entry requirements for a degree/major.

The following is the normal usage for this block, however the reqWithLink and reqOther can be empty.

reqWithLink allows the first element to be supplied with a blue button linking to another page.

The reqOther is simply an array of strings.


Code Block
{
    "contentType" : "entry-requirements",
    "heading"     : "Entry requirements",
    "content"     : "To be accepted into this degree you need:",
    "reqWithLink" : {
        "content"   : "University Entrance, or to meet the requirements of another admission type and",
        "linkText"  : "University admission",
        "linkTitle" : "University admission",
        "link"      : "%globals_asset_url:194328^json_encode%"
    },
    "reqOther"    : [
        "A Guaranteed Entry Score of 180 points from your NCEA."
    ]
}


fun-fact

Used for fun facts. Provides a Heading and content block.

Code Block
{
    "contentType": "fun-fact",
    "heading": "29%",
    "content": "Proportion of MBAs employed at or above the board level within six to ten years of graduating. Source: The Association of MBAs 2010 Career Survey"
}


important-info

Currently only used in undergraduate degrees pages. (For example in tourism-management)

On requirements pages, the last two values are nearly always:

  • The academic [Calendar] is the authoritative source of programme and course information.
  • If you have questions talk to a <a href='%globals_asset_url:186845%'>Liaison Officer</a>. If you’re already a student here, contact a <a href='%globals_asset_url:59208%#student-advisers'>student adviser</a>.

 With the href for the "student adviser" replaced with the appropriate faculty for that degree. See

Jira Legacy
serverJIRA (victoriauniversity.atlassian.net)
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId27f93f26-1c92-33a3-8ce5-991824ed6542
keyWIP-1390
for the appropriate asset number and anchor link to use.


Code Block
{
   "contentType" : "important-info",
   "heading"     : "Important information ",
   "content"     : [
            "If you are transferring from another university and applying for direct entry into the second year you'll need to supply a portfolio along with an official academic transcript. These must reach the <a href='http://www.victoria.ac.nz/fad/about/contact'> Faculty of Architecture and Design Office </a> by 10 December.",
            "<a href='Portfolio'>http://www.victoria.ac.nz/fad/pdf/portfolio-requirements-2012.pdf'>Portfolio requirements</a> (PDF 284 KB)",
            "The academic [Calendar] is the authoritative source of programme and course information.",
            "If you have questions talk to a <a href='%globals_asset_url:186845%'>Liaison Officer</a>. If you’re already a student here, contact a <a href='%globals_asset_url:59208%#student-advisers'>student adviser</a>."
        ]
}


intro-about

Used exclusively on the topic-about pages. Is basically the same as a content-plain container, but will also display a list of all the subjects next to it. Similar to the intro-degree container.

Code Block
{
	"contentType"    : "intro-about",
	"content"        : ""
}


intro-degree

Used at the start of each degree-about page. Is basically the same as a content-plain container, but will also display a list of all the majors next to it. Similar to the intro-about container.

Code Block
{
   "contentType" : "intro-degree",
   "heading"     : "",
   "content"     : ""
}

intro-major

Used at the start of each major on the degree>requirements page. Is basically the same as a content-plain container, but historically used to have other formatting as well. May be deprecated in future releases, but for now is still used at the start of each major. Similar to the intro-about container.

Code Block
{
	"contentType"              : "intro-major",
	"heading"                  : "",
	"content"                  : ""
}


intro-subject

Used at the start of each subject on the topic-study options page. Is basically the same as a content-plain container, but historically used to have other formatting as well. May be deprecated in future releases, but for now is still used at the start of each subject. Similar to the intro-about container.

Code Block
{
	"contentType" : "intro-subject",
	"heading"     : "",
	"content"     : ""
}


intro

Used at the start of each degree>requirements and topic>people & stories page. Is basically the same as a content-plain container, but historically used to have other formatting as well. Will hopefully soon be replaced by a content-plain block as it is confusing for it to be allocated to those specific areas. Similar to the intro-about container.

Code Block
{
	"contentType" : "intro",
	"heading"     : "",
	"content"     : ""
}


postgrad-apply

Used for the application/starting content block on postgraduate apply pages.

E.g. http://stage.victoria.ac.nz/explore/postgraduate-programmes/master-of-commerce-by-thesis/apply-contact?mode=admin&subject=accounting

Code Block
{
    "contentType" : "postgrad-apply",
    "content"     : {
        "startStudying" : {
            "type"     : "studyLengthTrimester",
            "heading"  : "Start Studying",
            "appendix" : "If you’ve missed the apply deadline, don’t worry—it’s still possible to make a late application. Contact the Programme Director to discuss your options.",
            "content"  : [
                {
                    "startDate"      :"%globals_asset_attribute_start_date_short:355524%",
                    "startTrimester" :"%globals_asset_metadata_trimesterNumber:355524%",
                    "applyBy"        :"%globals_asset_attribute_start_date_short:365079%"
                },
                {
                    "startDate"      :"%globals_asset_attribute_start_date_short:355515%",
                    "startTrimester" :"%globals_asset_metadata_trimesterNumber:355515%",
                    "applyBy"        :"%globals_asset_attribute_start_date_short:365077%"
                },
                {
                    "startDate"      :"%globals_asset_attribute_start_date_short:355523%",
                    "startTrimester" :"%globals_asset_metadata_trimesterNumber:355523%",
                    "applyBy"        :"%globals_asset_attribute_start_date_short:365078%"
                }
            ]
        },
        "linkTextfees" : :"Text",{
            "linkTitlecontentType" : "Textfees",
            "linkheading"     : :"%globals_asset_url:ASSETID^json_encode%"",
        }    ],
	"externalLinkscontent": [{ 		"linkText"   : "Text", 		"linkTitle"
 : "Text", 		"link"     }
 : "http://www.careers.govt.nz/"  	}]
}

 

 

 

content-facts

 

This is used exclusively on the degree-about pages. They supply the data for the "Level of study", "Length of full-time study", and "Useful secondary school subjects" contents.

 

This block does not change here. If these values are to change, they need to be done in the metadata of the degree. If this block changes from what is contained here it will most likely break things. Please don't do that... :(

 The startDate and startTrimester asset numbers are either:

Trimester 1: 355515

Trimester 2: 355523

Trimester 3: 355524

The applyBy asset numbers are either:

Trimester 1: 365077

Trimester 2: 365078

Trimester 3: 365079

Using the globals_asset keywords ensures that these values will return the correct results. At some point these lists will be automatically sorted by the angular app so that the closest date appears first, but for now they should be manually specified. (e.g. after the applyBy date for the second trimester has finished, make sure that the third trimester is the first one in the list).


For graduate qualifications, you need to specifically include a reference to the internationalApiCode in the content block. For example Graduate Diploma in Science, ID# 373377.

It looks like this:

Code Block
{
    "contentType" : "content-facts",
    "heading"     : "",
    "content"     : {
        "levelOfStudy": {
            "contentType" : "levelOfStudy",postgrad-apply",
    "heading"     : "International fees",
     "headingregion"      : "%asset_metadata_ProgrammeId^as_asset:asset_metadata_postOrUndergradHeading^json_encode%international",
    "content"     : {
 "content"      : "%asset_metadata_ProgrammeId^as_asset:asset_metadata_postOrUndergrad^json_encode%""startStudying" : {
        },    "type"    : "studyLengthstudyLengthTrimester": {,
            "contentTypeheading" : "studyLengthStart Studying",
            "headingcontent" : [
  : "%asset_metadata_ProgrammeId^as_asset:asset_metadata_LengthOfFulltimeStudyHeading^json_encode%",              {
 "content"     : "%asset_metadata_ProgrammeId^as_asset:asset_metadata_LengthOfFulltimeStudy^json_encode%",             "contentSubstartDate"      : "%asset%globals_metadataasset_ProgrammeId^asattribute_asset:assetstart_metadata_LengthOfFulltimeStudySubHeading^json_encode%"date_short:355524%",
        },         "fees": {  "startTrimester" :"%globals_asset_metadata_trimesterNumber:355524%",
         "contentType" : "fees",         "applyBy"    "heading"     : "%asset_metadata_ProgrammeId^as%globals_asset:asset_attribute_metadatastart_CourseFeesHeadingOverride^jsondate_encode%",short:365079%"
                "content"},
    : "%asset_metadata_ProgrammeId^as_asset:asset_metadata_EstimatedYearlyCourseFees^json_encode%"         },  {
      "usefulSubjects": {             "contentTypestartDate"      : "usefulSubjects","%globals_asset_attribute_start_date_short:355515%",
               "heading"     "startTrimester" : "%asset_metadata_ProgrammeId^as%globals_asset:asset_metadata_UsefulSecondarySchoolSubjectsHeading^json_encode%",trimesterNumber:355515%",
                    "contentapplyBy"        : "%asset%globals_metadataasset_ProgrammeId^asattribute_asset:assetstart_metadata_UsefulSecondarySchoolSubjects^json_encode%date_short:365077%"
        }       } }

 

 

entry-requirements

Used exclusively on the degree-requirement pages. Used for displaying the entry requirements for a degree/major.

The following is the normal usage for this block, however the reqWithLink and reqOther can be empty.

reqWithLink allows the first element to be supplied with a blue button linking to another page.

The reqOther is simply an array of strings.

Code Block
,
                {
    "contentType" : "entry-requirements",                "startDate"      :"%globals_asset_attribute_start_date_short:355523%",
        "heading"     : "Entry requirements",     "content""startTrimester" :"%globals_asset_metadata_trimesterNumber:355523%",
    : "To be accepted into this degree you need:",     "reqWithLink" : { "applyBy"        "content:"%globals_asset_attribute_start_date_short:365078%"
  : "University Entrance, or to meet the requirements of another admission type and",   }
     "linkText"  : "University admission",   ]
     "linkTitle" : "University admission"},
        "linkfees" : {
   : "%globals_asset_url:194328^json_encode%"     },   "contentType" : "reqOtherfees",
   : [         "heading"A Guaranteed Entry Score of 180 points from your NCEA.": "",
      ] }

fun-fact

Used for fun facts. Provides a Heading and content block.

Code Block
{     "contentType": "fun-fact",content"     "heading": "29%",
    "content": "Proportion of MBAs employed at or above the board level within six to ten years of graduating. Source: The Association of MBAs 2010 Career Survey"
}

 

important-info

Currently only used in undergraduate degrees pages. (For example in tourism-management)

On requirements pages, the last two values are nearly always:

  • The academic [Calendar] is the authoritative source of programme and course information.
  • If you have questions talk to a <a href='%globals_asset_url:186845%'>Liaison Officer</a>. If you’re already a student here, contact a <a href='%globals_asset_url:59208%#student-advisers'>student adviser</a>.

 With the href for the "student adviser" replaced with the appropriate faculty for that degree. See

Jira Legacy
serverJIRA (victoriauniversity.atlassian.net)
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId27f93f26-1c92-33a3-8ce5-991824ed6542
keyWIP-1390
for the appropriate asset number and anchor link to use.

 

Code Block
{
   "contentType" : "important-info",
   "heading"     : "Important information ",
   "content"     : [
            "If you are transferring from another university and applying for direct entry into the second year you'll need to supply a portfolio along with an official academic transcript. These must reach the <a href='http://www.victoria.ac.nz/fad/about/contact'> Faculty of Architecture and Design Office </a> by 10 December.",
    },
        "internationalApiCode" : "%globals_asset_metadata_ProgrammeId^as_asset:asset_metadata_internationalApiCode^json_encode%"
    }
}


Used exclusively on subject pages. Is how the subject links to the degree pages.

For "undergrad" contents:

The asset_assetid, asset_metadata_ProgrammeCode, asset_metadata_LengthOfFulltimeStudy, asset_metadata_WebPath, and asset_name should all use the same asset id value. This is the degree that the subject is linking to, and should always be the asset number of a degree page.

The leadsIntoLink, leadsIntoText, leadsIntoExtraPreText, leadsIntoExtraLink, leadsIntoExtraLinkText are all to do with postgraduate degrees the subject links to.

  • If they are all blank, no leads into will be shown.
  • If the leadsIntoLink and leadsIntoText are present, then there will be a "Leads to a" piece of content with leadsIntoText as the text, and leadsIntoLink as the url.
  • If the leadsIntoExtraPreText, leadsIntoExtraLink and leadsIntoExtraLinkText are present, then there will also be a second link provided in the "Leads to a" element.

This is a bit confusing, so see Architecture>Interior Architecture for a good example of how it is used. (Asset id 309042)

The content element is used to provide extra information about the related degree where necessary. This is just a plain text field. See Economics and Finance>Actuarial Science for a good example of this (asset number 309568).

For "postgrad" contents:

These are used solely for postgrad links. The assetid in asset_assetid and asset_metadata_WebPath should both be the same. Everything else gets edited in the json object.

A good example of this is Biomedical Sciences>Clinical Immunology (asset id 309688).

Code Block
{
    "contentType": "related-degrees",
    "content": {
        "<a href='Portfolio'>http://www.victoria.ac.nz/fad/pdf/portfolio-requirements-2012.pdf'>Portfolio requirements</a> (PDF 284 KB)",
undergrad": [{
			"asset_assetid"            "The academic [Calendar] is the authoritative source of programme and course information.",      : "%globals_asset_assetid:339832^json_encode%",
			"asset_metadata_ProgrammeCode"     "If you have questions talk to a <a href='%globals_asset_url:186845%'>Liaison Officer</a>. If you’re already a student here, contact a <a href='%globals_asset_url:59208%#student-advisers'>student adviser</a>."
        ]
}

 

intro-about

Used exclusively on the topic-about pages. Is basically the same as a content-plain container, but will also display a list of all the subjects next to it. Similar to the intro-degree container.

Code Block
{
	"contentType"    : "intro-about",
	"content": "%globals_asset_metadata_ProgrammeCode:339832^json_encode%",
			"asset_metadata_LengthOfFulltimeStudy" : "%globals_asset_metadata_LengthOfFulltimeStudy:339832^json_encode%",
			"asset_metadata_WebPath"               : "%globals_asset_metadata_WebPath:339832^json_encode%",
			"asset_name"                           : "%globals_asset_name:339832^json_encode%"
}

 

intro-degree

Used at the start of each degree-about page. Is basically the same as a content-plain container, but will also display a list of all the majors next to it. Similar to the intro-about container.

Code Block
{,
            "contentTypecontent" : "intro-degree",              "heading"     : "",    "content"     : ""
}

intro-major

Used at the start of each major on the degree>requirements page. Is basically the same as a content-plain container, but historically used to have other formatting as well. May be deprecated in future releases, but for now is still used at the start of each major. Similar to the intro-about container.

Code Block
{
	"contentType""",
			"leadsIntoLink"                        : "intro-major%globals_asset_url:62170^json_encode%",
			"headingleadsIntoText"                        : "Master of Architecture (Professional)",
	"content"
            "leadsIntoExtraPreText"                : "and other",
            "leadsIntoExtraLink"              :  "" }

 

intro-subject

Used at the start of each subject on the topic-study options page. Is basically the same as a content-plain container, but historically used to have other formatting as well. May be deprecated in future releases, but for now is still used at the start of each subject. Similar to the intro-about container.

Code Block
{ 	"contentType" : "intro-subject%globals_asset_url:62166^json_encode%",
	"heading"
           : "leadsIntoExtraLinkText",
	"content"          : ""
}

 

intro

Used at the start of each degree>requirements and topic>people & stories page. Is basically the same as a content-plain container, but historically used to have other formatting as well. Will hopefully soon be replaced by a content-plain block as it is confusing for it to be allocated to those specific areas. Similar to the intro-about container.

Code Block
{
	"contentType"    : "intro",
	"heading"postgraduate programmes"
       : ""}],
 	"content"      : "postgrad"
}

 

Used exclusively on subject pages. Is how the subject links to the degree pages.

For "undergrad" contents:

The asset_assetid, asset_metadata_ProgrammeCode, asset_metadata_LengthOfFulltimeStudy, asset_metadata_WebPath, and asset_name should all use the same asset id value. This is the degree that the subject is linking to, and should always be the asset number of a degree page.

The leadsIntoLink, leadsIntoText, leadsIntoExtraPreText, leadsIntoExtraLink, leadsIntoExtraLinkText are all to do with postgraduate degrees the subject links to.

  • If they are all blank, no leads into will be shown.
  • If the leadsIntoLink and leadsIntoText are present, then there will be a "Leads to a" piece of content with leadsIntoText as the text, and leadsIntoLink as the url.
  • If the leadsIntoExtraPreText, leadsIntoExtraLink and leadsIntoExtraLinkText are present, then there will also be a second link provided in the "Leads to a" element.

This is a bit confusing, so see Architecture>Interior Architecture for a good example of how it is used. (Asset id 309042)

The content element is used to provide extra information about the related degree where necessary. This is just a plain text field. See Economics and Finance>Actuarial Science for a good example of this (asset number 309568).

For "postgrad" contents:

These are used solely for postgrad links. The assetid in asset_assetid and asset_metadata_WebPath should both be the same. Everything else gets edited in the json object.

...

: [{
			"asset_assetid"                        : "%globals_asset_assetid:296680^json_encode%",
			"asset_metadata_ProgrammeCode"         : "MClinIm",
			"asset_metadata_LengthOfFulltimeStudy" : "1-2 years (180 points)",
			"asset_metadata_WebPath"               : "%globals_asset_url:296680^json_encode%",
			"asset_name"                           : "Master of Clinical Immunology"
        }]
    }
}


Used exclusively on subject pages for non-major subjects. (e.g. Linguistics>Text Technologies). Allows the subject to link to the victoria search page with the appropriate subject selected.


Code Block
{
    "contentType": "related-degreesnonmajor-courses",
    "content": {
        "undergrad": [{
            "undergrad": [{
			"asset_assetid"       subjectCode":"127",
            "content":"Learn more about the undergraduate courses available in Science in Society"
        }],
       : "%globals_asset_assetid:339832^json_encode%",
			"asset_metadata_ProgrammeCode"postgrad": [{
        : "%globals_asset_metadata_ProgrammeCode:339832^json_encode%", 			"asset_metadata_LengthOfFulltimeStudy" : "%globals_asset_metadata_LengthOfFulltimeStudy:339832^json_encode%",
			"asset_metadata_WebPath"subjectCode":"139",
            "content":"Learn more : "%globals_asset_metadata_WebPath:339832^json_encode%",
			"asset_name"    about the postgraduate courses available in Science in Society"
        }]
             : "%globals_asset_name:339832^json_encode%",
            "content"                              : "",
			"leadsIntoLink"                        : "%globals_asset_url:62170^json_encode%",
			"leadsIntoText"                   }
}


slide-show

(architecture has a good example of a slideshow)

See the appropriate confluence page on how to properly form a slideshow. But basically, the heading and caption are displayed above the images.

For the image objects, the caption, altText, and url are all provided via the globals_asset_attribute keyword. So if they are to be changed, it must be done on the details screen of the image asset.

Only the 'heading' is specified here, because the heading on the image asset might be different to what we want to display on the image itself, and in many cases is explicitly left out.

Code Block
{
	"heading"     : "Designing ideas",
	"contentType" : "slide-show",
	"caption"     : "Master of Architecture (Professional)",
	"images"      : [
    "leadsIntoExtraPreText		{
			"heading"       : "",
			"caption"       : "and other","%globals_asset_attribute_caption:340296^json_encode%",
			"altText"       : "%globals_asset_attribute_alt:340296^json_encode%",
			"buttonText"    : "",
			"leadsIntoExtraLinkbuttonLink"    : "",
			"buttonTitle"   :    "",
			"imageUrl"      : "%globals_asset_url:62166^json340296^json_encode%",
			"imageAssetId"  : "340296"
	    },
	    {
			"leadsIntoExtraLinkTextheading"       : "",
			"caption"       : "postgraduate programmes%globals_asset_attribute_caption:340276^json_encode%",
			"altText"         }],
  : "%globals_asset_attribute_alt:340276^json_encode%",
			"buttonText"    :  "postgrad":,
[{
			"asset_assetidbuttonLink"    : "",
			"buttonTitle"   :    "",
			"imageUrl"           : "%globals_asset_assetidurl:296680^json340276^json_encode%",
			"asset_metadata_ProgrammeCode""imageAssetId"  : "340276"
	    }
    : "MClinIm",
			"asset_metadata_LengthOfFulltimeStudy" : "1-2 years (180 points)",
			"asset_metadata_WebPath"               : "%globals_asset_url:296680^json_encode%",
			"asset_name"                           : "Master of Clinical Immunology"
        }]
    }
}

 

slide-show

(architecture has a good example of a slideshow)

See the appropriate confluence page on how to properly form a slideshow. But basically, the heading and caption are displayed above the images.

For the image objects, the caption, altText, and url are all provided via the globals_asset_attribute keyword. So if they are to be changed, it must be done on the details screen of the image asset.

...

]
}


video

Embeds a video. Currently only supports youtube videos. Make sure that the videoLink value is only the 'key' part of the video url. For example, https://www.youtube.com/watch?v=NYP5hSRiqBw becomes NYP5hSRiqBw.

The heading2 value was originally provided to supply sub-headings but is not currently used anywhere.

The content value provides a caption to go underneath the video.

videoImage is the image that will be used as the snapshot/preview that will display when the page first loads. Simply replace the ASSETID value in the code with the asset id of the image once it has been loaded into squiz.


Code Block
{
    "contentType": "video",
    "videoType": "youtube",
    "heading1": "Developing managers and leaders",
    "heading2": "",
    "content": "",
    "videoLink": "NYP5hSRiqBw",
    "videoImage": "%globals_asset_url:ASSETID^json_encode%"
}


wellington-promo

Also known as the 'Why Wellington" block. Used to provide a short promotion on why Wellington is such a great place to study. Normally the only thing changing is the content in "content" and sometimes the "heading". If the heading is not supplied, it should be left as "Why Wellington".

Note, for postgrad wellington-promo's, the asset id for the imageId and links might be changing. If so, please get Andrew Bredenkamp to update this part of the documentation.

Code Block
{
	"heading"     : "DesigningWhy ideasWellington",
	"contentType" : "slidewellington-showpromo",
	"captioncontent"     : "",
   	 "imagesimageLink"   : "%globals_asset_url:327370^json_encode%",
 : [ 		{ 			"headingimageId"       : "327370",
			"captionlinks"       : [
    	{
			"linkText"  :"Why "%globals_asset_attribute_caption:340296^json_encode%Wellington",
			"linkTitle" :"Why Wellington",
			"altTextlink"       : "%globals_asset_attribute_alturl:340296^json248382^json_encode%",
			"buttonText"
   : "",
			"buttonLink"	}
   : "",
			"buttonTitle"   : "",
			"imageUrl"      : "%globals_asset_url:340296^json_encode%",
			"imageAssetId"  : "340296"
	    },
	    {
			"heading"       : "",
			"caption"       : "%globals_asset_attribute_caption:340276^json_encode%",
			"altText"       : "%globals_asset_attribute_alt:340276^json_encode%",
			"buttonText"    : "",
			"buttonLink"    : "",
			"buttonTitle"   : "",
			"imageUrl]
}


Missing content blocks

Please list below any content types that are not covered above, and get Andrew Bredenkamp to write up appropriate documentation on them.


Linking between tabs

If you want to link to a section in a different tab within the same area (e.g. accounting>about linking to accounting>qualifications), you can't just use a regular <a href="../about">. Instead use the following code for the right page type:

Postgraduate programmes (postgraduate-programmes) - tabs = #about #study #requirements #people #apply

Code Block
<a ui-sref='postgrads#people'>link text</a>

Postgraduate subjects (postgraduate-subjects) - tabs #about #qualifications #people

Code Block
<a ui-sref='postgrad-areas#people'>link text</a>

Graduate qualifications (graduate-quals) - tabs = #about #study #requirements #people #apply

Code Block
<a ui-sref='graduate-quals#people'>link text</a>

Undergrad study areas (study-areas) - tabs = #about #study #people

Code Block
<a ui-sref='study-areas#people'>link text</a>

Undergrad degrees (degrees) - tabs = #about #requirements

Code Block
<a ui-sref='degrees#requirements'>link text</a>

International and Domestic content

Most of the international content is handled by the app. Including fees, requirements etc.

However there are some blocks which are set to be visible only for international or domestic students. This is set with the "region" value set to either "domestic" or "international".

E.g. asset id 341060

Code Block
{
    "contentType" : "content-plain-links",
    "heading"     : "Scholarships",
    "region"      : "%globals_asset_url:340276^json_encode%domestic",
			"imageAssetId"   : "340276content" 	    }: "Scholarships    ]
}

 

video

Embeds a video. Currently only supports youtube videos. Make sure that the videoLink value is only the 'key' part of the video url. For example, https://www.youtube.com/watch?v=NYP5hSRiqBw becomes NYP5hSRiqBw.

The heading2 value was originally provided to supply sub-headings but is not currently used anywhere.

The content value provides a caption to go underneath the video.

videoImage is the image that will be used as the snapshot/preview that will display when the page first loads. Simply replace the ASSETID value in the code with the asset id of the image once it has been loaded into squiz.

Code Block
{
    "contentType": "videoare awarded to hundreds of first-year students each year. They help with tuition fees and accommodation costs at Victoria's halls of residence. There are two types of scholarships for school leavers—Victoria Excellence Scholarships and Victoria Achiever Scholarships.\nYou can also apply for a TeachNZ Scholarship. These scholarships are awarded based on specific areas where teachers are needed.",
    "videoType": "youtube",links"       : [{
        "heading1linkText"  : "Search scholarships"Developing,
 managers and leaders",     "heading2linkTitle" : "Search scholarships",
        "contentlink": "",     "videoLink": "NYP5hSRiqBw",http://www.victoria.ac.nz/study/student-finance/scholarships"
     "videoImage": "%globals_asset_url:ASSETID^json_encode%"
}

 

wellington-promo

Also known as the 'Why Wellington" block. Used to provide a short promotion on why Wellington is such a great place to study. Normally the only thing changing is the content in "content" and sometimes the "heading". If the heading is not supplied, it should be left as "Why Wellington".

Note, for postgrad wellington-promo's, the asset id for the imageId and links might be changing. If so, please get Andrew Bredenkamp to update this part of the documentation.

Code Block
{
	"heading"     : "Why Wellington",
	"contentType" : "wellington-promo",
	"content"     : "",
    "imageLink"   : "%globals_asset_url:327370^json_encode%",
    "imageId"     : "327370",
	"links"       : [
    	{
			"linkText"  :"Why Wellington",
			"linkTitle" :"Why Wellington",
			"link"      :"%globals_asset_url:248382^json_encode%"
    	}
    ]
}

 

Missing content blocks

Please list below any content types that are not covered above, and get Andrew Bredenkamp to write up appropriate documentation on them.

 

}]

}


By default content will appear to anyone who visits the page. If the region is domestic, it will only show to non-international students. If the region is international, it will only show to international students.

This can be applied to any content block.


Tooltips

There are three kinds of tooltips. 

  1. Standard tooltips that appear in text which has a dotted line under it, where the tooltip will appear when the user hovers over the word.
  2. Heading tooltips - e.g. on the Study Areas About tab, on the question mark icon by the heading Subjects "Possible area(s) of study within a degree"
  3. Other tooltips that have ended up being handled by the Angular App.

For standard tooltips, these are managed in each qualification areas sharedAssets folder.

E.g. sharedAssets (Id: #313981) > toolTips (Id: #329802) for study areas.

They are formatted just like any other json object:

Code Block
"word for tooltip to appear" : "Tooltip text that will appear on hover",

Make sure the last item before the final } doesn't have a , after it so it retains valid json syntax.

it doesn't matter what capitalisation you use for the tooltip word, and it can include spaces and other characters (except " marks). Once the new word is in place, the next time you load the page the tooltips should be appear wherever that word appears.

Note, this is a fairly intensive process on angular end, so it is better if we try to keep this list of tooltips to a minimum wherever possible.


Also, the tooltips generally are broken into 4 parts.

  1. The opening bracket (can be ignored)
  2. A container that is exclusive to study areas
  3. A container that is shared across study areas, undergrad degrees, grad-quals and postgrad programmes
  4. Closing Bracket (can be ignored)

This allows specific tooltips only to appear in their designated area without adding extra values and processing to other areas. In future it might be worthwhile to regularly do an audit on the tooltips to ensure there are not any extra tooltips that are no longer needed, or if there are tooltips that are only required on postgrad that don't need to be shared.

Squiz keywords. When and how to use them:

...

please ensure ^json_encode is used on every keyword that is used. Not doing so may end up causing very hard to find issues further down the line.

 


./?a=ASSETID

This is a sort of short hand way of doing %globals_asset_url:10% that only works in href values. (ie <a href='./?a=10'>link text</a>). However, it does not play nicely with the json objects so we don't use it. It is mentioned here solely in case it is encountered in other areas of the site. 


%globals_asset_attribute_BLAH:ASSETID^json_encode%

...

%globals_asset_attribute_alt:340296^json_encode% returns the alt-text of the image. 

 


%globals_asset_metadata_BLAH:ASSETID^json_encode%

This is used to get metadata values of the specified asset. These are edited via the metadata page of that asset.

 


%globals_asset_file_size_readable:ASSETID^json_encode% and %globals_asset_type_icon:ASSETID^json_encode%

...

For example <a href='%globals_asset_url:54655^json_encode%#advisers'>link text</a> will link to http://www.victoria.ac.nz/vbs/about/staff#advisers. 


New lines in text

If you are getting corrupt json values, there is a good chance it is because there is a newline in it somewhere. These are not allowed as they break json objects. When importing content, make sure that all newlines are replaced with:

...

\n


So this:

Code Block
Any building you enter has a complex history—from concept, to design, to construction.

Study a Bachelor of Building Science and gain a solid understanding of what it takes to develop a building that's efficient and sustainable and safe. Learn how to organise teams, plan the construction process and manage contractors and constructions sites.

Get the basics alongside Architecture students in the first year, then specialise in Sustainable Engineering Systems or Project Management.

At the end of your Bachelor’s degree you can stay on and study for a Master of Building Science. You’ll graduate skilled and work ready.

...

Code Block
{
	"contentType"    : "content-plain",
	"heading"        : "",
    "content"        : "Any building you enter has a complex history—from concept, to design, to construction.\nStudy Building Science and gain a solid understanding of what it takes to develop a building that's efficient and sustainable and safe. Learn how to organise teams, plan the construction process and manage contractors and construction sites.\nGet the basics alongside Architecture students in the first year, then specialise in Sustainable Engineering Systems, Project Management or both.\nAt the end of your Bachelor’s degree you can stay on and study for a Master of Building Science. You’ll graduate skilled and work ready. "
}

...


This is then turned into <p> tags via the angular app where necessary, but this should not cause an issue. 

JSON specifics in formatting and common pitfalls
...
The commas are a particularly nasty issue, because nearly every json parser will allow there to be a comma after the last element without issue. The json interpreter within squiz though does not, and so some values that the angular app needs might be missing - such as the contentType and the region. Use the online validator here if you are unsure whether your commas are correct or not. 

Debugging json objects
If you try to load a page and you get the following error:
...