Oxford Talks tile/portlet

You will require this information when you wish to use the Oxford Talks tile, Profile tile or portlet.

Step-by-step guide to using the Oxford Talks Coverpage/Profile Tile

  1. Navigate to the 'Layout' view of the cover page or profile that you would like to add the Oxford Talks tile to.
  2. Drag and drop the 'OxTalks' tile into the layout and position it where you would like it - then save the layout (when editing a profile tile, you can edit the tile before saving the layout - skip to step 4).
  3. Once you have saved the layout, switch to the 'Compose' view.
  4. Once in the 'Compose' view, hover over the Oxford Talks tile, and click on the blue edit button that appears in the top left corner.
  5. You will see a pop up that has three tabs on it:
    1. Content
      1. 'Title' - This field is for giving the tile a title.
      2. 'Select talks extra info to show' - using this field, you can define which attributes related to each of the talks will show on the tile.
      3. 'Date from' - This is where you can define the date to start the filtering on. If you want to use 'today', please leave this empty and check the tick box below.
      4. 'List talks starting today' checkbox - If you check this box, the 'Date from' field is ignored.
      5. 'Date to' - This is where you can define the date that the search will end, even if there are more events after the end dates in the filter that you are using, they will not be shown. 
        Leave blank to include all upcoming talks.
      6. 'Series' - This will show talks from a specific series. Supply the unique ID for the series - one per line. E.g. d47e2458-af73-4bc1-bf04-3c275e1c1254 (found at the end of the URL on the Oxford Talks website).
      7. 'Organising departments' - This will filter the talks by the department that you define here. Start to type in the search box, and it will suggest options for you.
      8. 'Include sub departments' checkbox - If this box is checked, all sub department items related to the department that you select will be included in the feed.
      9. 'Speakers' - This will filter the talks by a specific speaker. Supply the unique ID for a person - one per line. E.g. d47e2458-af73-4bc1-bf04-3c275e1c1254 (found at the end of the URL on the Oxford Talks website).
      10. 'Topics' - This will filter the talks that you are looking for by topic. Start to type in the search box, and it will suggest options for you.
      11. 'Venues' - This will filter the talks that you are looking for by the talks' venue. Start to type in the search box, and it will suggest options for you.
      12. 'Collection' - Use this field to enter the ID for the predefined collection of talks that has been defined in the Oxford Talks application.
      13. 'Limit' - This field allows you to define the number of items that will show in the tile, when they are pulled in from Oxford Talks. This allows you to define how much information shows in the tile, and therefore how tall it is.
    2. Style
      1. 'Box border' - allows you to define if the tile has a border
      2. 'Box type' - allows you to define if the box has a background colour
    3. Button
      1. 'Internal link' - Use the search box to find content within your website, that you want to direct users to using a button at the bottom of the portlet.
      2. 'External link' - Use this field to put an external URL, to link users to from a button at the bottom of the portlet. 
      3. 'Button text' - Use this field to define the text on the 'read more' button.
      4. 'Button Alignment' - to set where on the tile the button aligns to
      5. 'Button type' - to define what type of button is used
    4. 'Save' - To save the changes made to the tile.
    5. 'Cancel' - To cancel the changes made to the tile.

Step-by-step guide to using the Oxford Talks Portlet

  1. Navigate to the page where you would like to add the Oxford Talks portlet.
  2. Using the dropdown menu from your account name, in the top right of the page, on the edit bar, select 'Manage portlets'
  3. You will be taken to the 'Manage portlets' page.
  4. Using the drop down menu on the appropriate 'Primary' or 'Secondary' portlet column, select 'OxTalks'
  5. You will see a form that has three tabs on it:
    1. Content
      1. 'Title' - This field is for giving the tile a title.
      2. 'Select talks extra info to show' - using this field, you can define which attributes related to each of the talks will show on the tile.
      3. 'Date from' - This is where you can define the date to start the filtering on. If you want to use 'today', please leave this empty and check the tick box below.
      4. 'List talks starting today' checkbox - If you check this box, the 'Date from' field is ignored.
      5. 'Date to' - This is where you can define the date that the search will end, even if there are more events after the end dates in the filter that you are using, they will not be shown. 
        Leave blank to include all upcoming talks.
      6. 'Series' - This will show talks from a specific series. Supply the unique ID for the series - one per line. E.g. d47e2458-af73-4bc1-bf04-3c275e1c1254 (found at the end of the URL on the Oxford Talks website).
      7. 'Organising departments' - This will filter the talks by the department that you define here. Start to type in the search box, and it will suggest options for you.
      8. 'Include sub departments' checkbox - If this box is checked, all sub department items related to the department that you select will be included in the feed.
      9. 'Speakers' - This will filter the talks by a specific speaker. Supply the unique ID for a person - one per line. E.g. d47e2458-af73-4bc1-bf04-3c275e1c1254 (found at the end of the URL on the Oxford Talks website).
      10. 'Topics' - This will filter the talks that you are looking for by topic. Start to type in the search box, and it will suggest options for you.
      11. 'Venues' - This will filter the talks that you are looking for by the talks' venue. Start to type in the search box, and it will suggest options for you.
      12. 'Collection' - Use this field to enter the ID for the predefined collection of talks that has been defined in the Oxford Talks application.
      13. 'Limit' - This field allows you to define the number of items that will show in the tile, when they are pulled in from Oxford Talks. This allows you to define how much information shows in the tile, and therefore how tall it is.
    2. Themeing
      1. 'Box border' - allows you to define if the tile has a border
      2. 'Box type' - allows you to define if the box has a background colour
    3. Button
      1. 'Internal link' - Use the search box to find content within your website, that you want to direct users to using a button at the bottom of the portlet.
      2. 'External link' - Use this field to put an external URL, to link users to from a button at the bottom of the portlet. 
      3. 'Button text' - Use this field to define the text on the 'read more' button.
      4. 'Button Alignment' - to set where on the tile the button aligns to
      5. 'Button type' - to define what type of button is used
    4. 'Save' - To save the changes made to the tile.
    5. 'Cancel' - To cancel the changes made to the tile.