Author Legacy (v5.x): Tokyo
-
Components | Tab group
"Tab group" is a component that groups the content in a tab menu that we can explore. This component is added within the screens by default. (See here), it can also be added inside a row or a pop-up. You will find this component in the group of "Cataloguer" components. When creating the "Accordion" component, three "Tabs" are included by default. Each "Tab" is organised in two areas: A title. A content area including a sample text. This area allows including new components within. This component has a complex structure, as it consists of many elements having their own specific properties. In order to configure it correctly, we should pay attention and select the right element. We can select elements from the breadcrumb trail and from the "Structure" tab. Breadcrumb trail "Structure" tab Setup process 1. When creating this component, three elements are included by default. Go to "Add" and include the "Tabs" we need. 2. Go to the "Properties" tab and configure the parameters for the Tab Group. 3. Write a title for each "Tab". 4. Select the content area within the "Tab" and add your own content. A sample text is added by default, but we can add the components we prefer to the "Add" tab. Properties PROPERTY DESCRIPTION It offers two views of the tabs: Classic: shows the activated label in a more marked color tone: With border: shows the activated label with a border: Style This property allows modifying the graphic layout of a tab group: Standard: primary and secondary colours can be applied to the unit, when appropriate to the chosen view (See here to learn how to configure the colours). Customised: customised colours can be applied to the accordion. Depending on the selected "View", new properties will be enabled to let you modify border, background and title colours. Width This property allows changing the space occupied by a component inside a central column of contents. This component occupies 100% of the space by default, but size can be reduced to other preset percentages or changed to "full-size". Some quote styles may overlap the central column if "Full" width is chosen. Align This property allows placing the component on the right, on the left or on the centre of the central column where contents are shown. It can only be used when applied "Width" is less than 100%. Overcome goal It allows to modify the configuration of the overcoming of the objectives of this concrete component. We can choose between: Inherited: this option aply the default value defined in the Completion Objectives Area (See here). Non objetive: this audio will not an objetive to complete the unit. Interact: It is necessary interact with the component to reach the objective. Complete: it is necessary to visit all the tabs to overcome the goal.
-
Components | Row
"Row" is one of the most adaptable and interesting components offered by the Tokyo template. This component allows inserting "Columns" to order the rest of components. So, we can decide to display the information divided into columns. We would find a similar layout in newspapers, for instance. Rows can be divided into 12 columns. We can add "Columns" to occupy 1-12 out of all the spaces available. For instance, we can add two symmetrical columns (6 spaces each), three symmetrical columns (4 spaces each), etc. We can also create asymmetrical layouts consisting of columns with different layouts. Rows are added within the screens by default (See here), but they can also be added inside other components (for example, a Pop-up, an Accordion, a Row, etc.). You will find this component in the group of "Cataloguer" components. When we add a row, we can choose different preset structures that will help us when editing contents. Setup process 1. Check the selected row (you can check this quickly from the breadcrumb trail), access the "Add" tab and, if needed, include new "Columns". 2. Access the "Properties" tab in the row and configure its properties (see the list of properties at the bottom of this page). Properties used to choose a background image or colour for the row are interesting. It is also possible to let the row width exceedthe central area of the screen. 3. Columns we created include a text by default, but there are also other components we can insert in the column. We select the column (the easiest way to do this is through the breadcrumb trail), access the "Add" tab and choose one of the components to "Insert inside" the column. Remember you can go to "Insert after" and add another column after this column. 4. Finally, access the "Properties" tab in the column. For example, this tab allows you to assign a width to each column included inside the row (1 to 12 spaces). Row properties PROPERTY DESCRIPTION Width The row occupies 100% of the available space by default, but size can be changed to "Full", that is, size can be adjusted to fit the central column width. Right margin This property allows defining where the right margin should finish. None: Default option. level 1: The margin is aligned to one side of the central column. level 2: The margin exceeds 50px the side of the central column. level 3: The margin exceeds 100px the side of the central column. If we combine the "Right margin" with the "Left margin" property, we can configure the same margin for both sides of a row. Left margin This property allows defining where the left margin should start. None: Default option. level 1: The margin is aligned to one side of the central column. level 2: The margin exceeds 50px the side of the central column. level 3: The margin exceeds 100px the side of the central column. If we combine the "Left margin" with the "Right margin" property, we can configure the same margin for both sides of a row. Background image This property allows adding a background image for the row. We will click on "Examine" to access the unit Resources folder (check here ), and select the image we want to show. Supported image formats: jpeg, png, and gif. Background colour This property allows adding a background colour for the row. If we add a "Background image", this will prevail over the background colour. Column properties Lets decide how the column will be resolved in the printable version in pdf: - Yes: the content of the column was defined with the "Size" defined. Thus, if there are contents in 3 columns, they will be seen in the same way in the printable version. - No: will make the content of the column see a full size in the PDF (12 spaces). This will be positive if we want the columns to be displayed on top of each other in the PDF version for easy reading. We will be useful if we have content For example, if we create 3 columns with flipping images, we can decide if the 3 are shown online in the pdf with the option "Yes": PROPERTY DESCRIPTION Size This is the size occupied by a column inside a row. Columns can occupy 1-12 spaces. Animation This property allows adding an animation effect when a column appears: None: No effect. Fade: Appearance effect. Fade up: Appearance from the bottom of the screen. Offset This option allows creating a breaking space on the left of the column, which can be visually noticed. Offset can have 1-12 spaces. It's the last column This property allows marking a column as the last one within a row. This means that the second column will be placed below the first column, so that the third column appears as the last one within the row. This example shows that more options could have included in the first row, but we decided to insert them in the next row. Keep size in PDF version Lets decide how the column will be resolved in the printable version in pdf: - Yes: the content of the column was defined with the "Size" defined. Thus, if there are contents in 3 columns, they will be seen in the same way in the printable version. - No: will make the content of the column see a full size in the PDF (12 spaces). This will be positive if we want the columns to be displayed on top of each other in the PDF version for easy reading. We will be useful if we have content For example, if we create 3 columns with flipping images, we can decide if the 3 are shown online in the pdf with the option "Yes": Or if they are displayed in full size for easy reading with the option "No":
-
Components | educaPlay
"EducaPlay" component allows adding games and activities created with the EducaPlay tool., Depending on the type of subscription chosen by users, this tool allows downloading and using activities shared inside the community in other platforms like Author. This component is added within the screens by default (See here), but it can also be added inside other components (for example, inside a Pop-up, a Row, etc.). You will find this component in the group of "Activity" components. Remember It is important to remember that this is an external element, so we have limited control over it. That means: We can check whether students have completed an activity. This will allow us to turn EducaPlay components into goals that must be achieved and/or elements that limit progress with progressive navigation. We do not keep any data regarding this interaction (i.e. we do not save answers provided by students, for instance). This component does not count towards total score or unit progress. We do not know the answers and we will not record right/wrong results, so this score will not be included when calculating the average score. For that reason, we recommend using this component for animations and additional games. We recommend using the "Reinforcement activity" component (See here) or "Quiz" component (See here) to add specific activities and control them better. Setup process 1. Access the "Properties" tab, go to "Resource (.zip)" and click on "Examine" to find and select the EducaPlay activity zip file in the unit Resources folder (see here ). 2. Go to "Launcher name" property and select the boot file name and extension of the activity. If the downloaded EducaPlay zip file has not changed, there will be no need to modify this field. 3. Set up the rest of properties for this component. Properties PROPERTY DESCRIPTION Title Name of EducaPlay activity. When adding components to the "Carousel", this property helps to identify them when shown in miniature in the Resources gallery. (See here) Resource (.zip) This property allows adding the zip file that contains the activity. Click on "Examine" to find the file in the unit Resources folder (see here ). If we want to modify the EducaPlay activity that will be shown within this component, we should click on "Examine"and select the new zip file. Then, we should click on "Update" to load the new content. Launcher name This property indicates boot file name and extension of the activity. If the downloaded EducaPlay zip file has not changed, there will be no need to modify this field. Aspect ratio This property allows adjusting the height-width ratio (16:9, 8:5 o 4:3). Width This property allows changing the space occupied by a component inside a central column of contents. The component occupies 100% of the space by default, but size can be reduced to other preset percentages or can be displayed in "full-size". Some quote styles may overlap the central column if "Full" width is chosen. Align This property allows placing the component on the right, on the left or on the centre of the central column where contents are shown. It can only be used when applied "Width" is less than 100%. Float It allows inserting a component and "wrap" it with a text. First, we should select a size percentage under 100% in "Width" property (25%, for instance). "Float" property allows us to decide where we would like to put the floating component (on the right or on the left of the text). We use arrows to move the component and put it on the text.
-
Components | Quiz
"Quiz" is a component that includes one or more questions to assess student knowledge. It consists of an opening screen where contents are introduced, and a closing screen where students can get some feedback on their results. We recommend adding the quiz within the screens (See here), but it can also be added inside other components (for example, inside a Pop-up, a Row, etc.). You will find this component in the group of "Activity" components. Remember Quizzes can be considered too mark a unit as complete, which means quiz score can imply that we mark the unit as passed or not passed. In order to send quiz scores to the LMS, we must go to quiz properties and mark them as "Assessable". This way, a unit could have 2 quizzes but only one could count towards the final score. Setup process 1. Define a title for the quiz. 2. Write the text for the quiz cover. 3. Go to the "Properties" tab and configure its properties. At least we should choose the type of quiz we want to include, so we go to the "View" property: Quiz view: This view consists of a traditional assessment quiz: once students have answered all the questions, the quiz is corrected. It consists of a cover/opening screen, and a closing screen including feedback for students. When we answer a question, we go to the next question. Feedback only appears after finishing the quiz. Activity block view: This view is simply a group of questions shown together. It does not have an opening or closing screen and each question is answered individually, so feedback appears as soon as you reply. Furthermore, as these are independent questions, some offer more attempts and some others offer less. 4. Access the "Add" tab and include some activities. A simple answer activity is created by default, but we can delete it and choose another type of activity. For further information about available activities, please check here. 5. Finally, write texts for the closing screen of the quiz. Options are: Neutral feedback: this is a type of text that will always appear, regardless of results obtained for the quiz. Positive feedback: this type of text will be shown when students pass the quiz. Negative feedback: this type of text will be shown when students do not pass the quiz. If we do not want any feedback at all, we just need to remove the text and leave the field blank. Remember Bear in mind that quiz feedback is not the same as question feedback. Each activity can have its own feedback, including texts with customised information about a question that will only be shown once students have finished answering the quiz with a pass or a fail. They will go to the Review view to check feedback. Quiz feedback will always be shown when students complete a quiz. It is a generic and global feedback that says if a quiz is passed or not. Quiz properties PROPERTY DESCRIPTION View There are two types of view: Quiz: This view consists of a traditional assessment quiz: once students have answered all the questions, the quiz is corrected. There is an opening screen, and a closing screen including feedback for students. When we answer a question, we go to the next question. Feedback appears after finishing the quiz. Activity block: This view is simply a group of questions shown together. It does not have an opening or closing screen and each question is answered individually, so you get some feedback as soon as you reply. Furthermore, different questions can offer more or less attempts to find the correct answer. Randomize This property allows showing the list of questions randomly. When this function is activated, the quiz is created, and this property also creates a group of activities with a random order. When creating the list, the "Max. nº of questions" is respected. IMPORTANT: New attempts do not generate a new list of questions. The same group of questions chosen for the first attempt will be shown for the rest of attempts. However, we can decide if questions should reorganise after the first attempt choosing an option inside "When is it reordered" property. Enable bookmark Functionality only available in the "View" type "Quizz".It allows adding a bookmark in activities. The student could indicate with this marks, for example, the activities about which he has doubts. When is it reordered This property is related with "Randomize". It allows deciding when questions are reordered. First time: questions are reordered the first time the quiz is generated. The following attempts will include the same questions displayed in the same order. Each time: Question order will change each time students try to pass the quiz. Max. nº of questions This property allows deciding how many questions will be shown. So, we could create a quiz having 20 questions, but choose to show only 5 of them. This property is related to "Randomize". If questions are not ordered randomly, they will always be shown according to their creation date (regarding the previous example, the first 5 questions would be shown). If we choose to randomize questions, X questions will be shown randomly when creating the quiz. That means we will create a selection of questions, and a different group of questions will be shown to each student. Assessable It is possible to define if you want the quiz to be assessed or not, that is, whether you would like to send the quiz score to the LMS. Width This property allows changing the space occupied by a component inside a central column of contents. The component occupies 100% of the space by default, but size can be reduced to other preset percentages or can be displayed in "full-size". Some quote styles may overlap the central column if "Full" width is chosen. Align This property allows placing the component on the right, on the left or on the centre of the central column where contents are shown. It can only be used when applied "Width" is less than 100%. Mastery Functionality only available in the "View" type "Quiz". It is the minimum score required to pass the quiz. A 100% score is required by default to pass it. In the "View" type "Activity block" this property has no functionality. Attempts Functionality only available in the "View" type "Quiz". It allows to define the number of attempts that the student has to finish the quiz. In "Activity Block" view this property doesn't exist. The specific attempts are configured in the each activity. IMPORTANT: You can define unlimited attempts for a questionnaire: To do this you must mark 0 attempts. Weight This property allows deciding how each question counts towards the total course score. (See how to calculate this value at the bottom of this page). SCORM Objective This property allows choosing the skills or academic goals achieved when completing this quiz. This option is useful when the platform used to publish a unit keeps record of these data. Show button finish This property allows you to display a "Finish" button in the "Questionnaire" view. This button will be show on the final summary screen of the questionnaire, once the student has completed one of the available attempts. If the student has not spend all attempts, the student may: - Retry, to improve your score. - Finalize the questionnaire, keeping the score obtained (whether approved or not). It is useful when the student has passed the questionnaire but there are still attempts available. If you do not want to try again or improve your grade, at the end you can review the questionnaire and check its successes and failures. Show timer Time limit (seconds) These options allow you to activate a timer. If in "Time limit (seconds)" we leave 0 seconds, a counter will be displayed that will record the time that the student uses to answer and finish the questionnaire. If in "Time limit (seconds)" a time is marked (eg, 30 seconds), a countdown will be displayed and, once this time limit has expired, the questionnaire will end automatically, preventing the student from making more answers. With the countdown configuration, the students only will have 1 attempt. NOTE: If you leave the questionnaire before ending it (change the screen in the content, close the unit ...), when you return the counter will be stopped, keeping the last time recorded. The student will have to press Play to continue answering the questionnaire. Overcome goal A questionnaire will be completed based on what is selected in the "Overcome goal" property. Depending on the values of this property, its behavior will be as follows: Inherited: it is completed based on what is indicated in the course properties (more info here). It is not objective: it is not taken into account as the objective of the course. Send: is completed when done the first time (by clicking on the "Results" button). Overcome or complete: it is considered complete when approved or when exhausting attempts. In this way, if we link the objectives to navigation, the student will not be able to advance to the next screen or page until the questionnaire is approved. Thus, if we mark that it must "overcome or complete" and we have sequential navigation linked to objectives, the student will not be able to advance to the next screen as long as he does not approve or exhaust the attempts. If you have unlimited attempts, the advance will be unlocked as soon as you exceed the minimum score, although you can continue making infinite attempts until you reach 100% of the grade. Score calculation All the quiz scores are calculated as follows. However, remember that only the score of those quizzes marked as "Assessable" will count towards the final unit score. Quiz score calculation The equation to calculate the score of a quiz is as follows: This is the formula for a quiz having 5 questions (3 simple answers and 2 multiple choice) * *Each type of question has a specific formula to find its own score. Changing question weight in a quiz We can go to the Properties tab inside each question to modify the weight or importance we give to questions when calculating the final score. When we give weight to a question, the formula used to calculate the score is as follows: We should bear in mind that default weight is 1. For instance, we can take the previous quiz as an example and decide that the first question weight is 3, which means that it triples the default weight of the rest of questions (1). Score calculation would be: Quiz weight When a unit consists of various quizzes, the formula used to calculate the final score of this unit is like calculating the score of a single quiz: If we have 2 quizzes, 90% score for the first one and 50% score for the second one, the final score will be: Changing quiz weight We can change the weight or importance of a quiz or single activity when calculating the final score. When the weight of a quiz is changed, score is calculated with this formula: If we take the previous examples, we can decide to give a double weight (2) to the second quiz only and leave the weight of the first quiz as it is (1). The formula would be as follows:
-
Components | Quizz Conector
The component "Quizz conector" allows to link an external Quiz, created with the "Tokyo Activities" template. So we could create disaggregated activities of the content unit and link them in one or several independent units. After adding the component, we access the "Properties" tab where we can: Create: allows you to create a quiz from the "Tokyo Activities" template from scratch. Link: allows you to search an existing quiz and link it. Unlink: removes the existing link to a quiz. Edit: allows you enter in the edition mode of the linked quiz and modify it.
-
Components | Reinforcement activity
"Reinforcement activity" component allows creating activities including them across a unit. This type of activity is used for self-assessment and knowledge reinforcement. We do not mark these activities (score is not sent to the LMS), which can only consist of one question. We recommend adding this component within the screens (See here), but you can also add it inside other components(for example, inside a Pop-up, a Row, etc.). You will find this component in the group of "Activity" components. Setup process 1. Choose a title for the Reinforcement activity. 2. Go to the "Properties" tab and configure general properties for this activity. 3. Access the "Add" tab and include the question we need. We can only add one question. Properties PROPERTY DESCRIPTION Attempts This property allows adding the number of attempts available to complete an activity: Unlimited: students will have an unlimited number of attempts to complete the activity. 1, 2 and 3: students will have a limited number of attempts (1, 2 or 3) to complete the activity. Width This property allows changing the space occupied by a component inside a central column of contents. The component occupies 100% of the space by default, but size can be reduced to other preset percentages or can be displayed in "full-size". Some quote styles may overlap the central column if "Full" width is chosen. Align This property allows placing the component on the right, on the left or on the centre of the central column where contents are shown. It can only be used when applied "Width" is less than 100%. Overcome goal It allows to modify the configuration of the overcoming of the objectives of this concrete component. We can choose between: Inherited: this option aply the default value defined in the Completion Objectives Area (See here). Non objetive: this audio will not an objetive to complete the unit. Submit: it is necessary to answer the reinforcement question (it is not necessary to pass). Pass or complete: it is necessary answer the question correctly or exhaust the available attempts.
-
Components | Section
The "Section" component allows you to create content that is displayed at the full width of the screen, regardless of the width defined for the center column. Configuration The section can be added within a screen, in any position (e.g. between two texts). If it is located at the top of the screen, it is glued, without margins, to the top area, so it is a good component to create headlines. A section counts, by default, a row and a column. Inside the row and column you can add any other component. Sections allow you to add multiple rows inside. Its properties are: PROPERTY DESCRIPTION View Lets you select from 2 possible views: - Full width content. The content occupies the entire width available on the screen (full screen) - Content adjusted to the center lane. The bottom of the section occupies the entire width available on the screen (fullscreen) but the content (texts, images ...) adjusts to the width of the center lane. Title Component title Background image You can add a background image for the component. Background colour You can set a background color for the component Background type Lets you decide the background type if you add a background image: - Repeat background: repeat the background image until all available space is filled - Do not repeat background: Does not repeat the background image, the image added to its size is displayed.
-
Components | Glossary
A "Glossary" is a pop-up element where keywords related to a course are included. It is an element that can be added within a screen, but we recommend adding it within a pop-up. You will find this component in the group of "Structure" components. Setup process We can follow one of these methods to create a glossary: Manual creation Automatic creation importing a csv file Link a complete glossary or one of its terms Methods cannot be combined, so we must choose one of them. Manual creation This method requires adding terms one by one. This is an advantage because: We can add images to terms. We can create a direct link to a glossary term in the content. 1. We access to the "Properties" tab. Then we can configure: View. We can choose two different types of glossary: "Advanced glossary" and "Basic glossary". The "Advanced glossary" is a good option when there are many terms; it makes term organisation easier because terms are shown in alphabetic order. Order of the glossary elements. Here we can decide how we want to order terms (by insertion order, descending order (A to Z) or ascending order (Z to A) 2. We enter the "Add" tab and include the "Glossary items" we need. 3. We select each "Glossary item" and access the "Properties" tab. Here we can include a key "Term identification" chosen from the glossary. This will allow us to link this term with a word included in the contents. We should remember to include this text, as we will use it whenever we want to create a direct link to the term included in the glossary. 4. Notice that each "Glossary item" consists of: A term, which is a title. A content area including a sample text by default. So, we should do the following: a. Edit the "Term" text (that is, the title of the glossary item) b. Go to "Description" and write the text we want to add. c. Select the "Description", access the "Add" tab and, if appropriate, we can add an "Image". Automatic creation importing a csv file This method is faster than the previous one but has some disadvantages: We cannot add images to terms. We cannot create a direct link to a glossary term. You cant modify the glossary before you import it. You need to create a new csv with the changes and import it. 1. We access to the "Properties" tab. Then we can configure: View. We can choose two different types of glossary: "Advanced glossary" and "Basic glossary". The "Advanced glossary" is a good option when there are many terms; it makes term organisation easier, as terms are shown in alphabetic order. Order of the glossary elements. Here we can decide how we want to order terms (by insertion order, descending order (A to Z) or ascending order (Z to A) 2. Go to the "Import glossary" property, click on "Examine" to find and associate the .csv file from the unit Resources folder (see here). 5. When adding the .csv file, a pop-up alert appears to inform that this action will remove other terms that were manually added to the glossary. After clicking on "OK", glossary terms will be added to the .csv file Link a complete glossary or one of its terms After creating a glossary, you can link it to various places (the whole glossary or only some terms). Link the glossary to the top Toolbar of a unit. Check how to do this in here Link the glossary to an image. In this case, you will be able to link the pop-up glossary. Check how to link a pop-up to an image here Link the glossary to a piece of text. In this case, you can choose a specific word from the glossary and show it in two different ways: A. Glossary link. We can open a glossary and apply filters to it so that only one word is shown. B. Glossary tooltip. We can make the term show as a tooltip window. In order to configure these modes, we should do the following: A. Glossary link. Select the text that will be linked, open the "links" drop-down menu, and select "Glossary link". Then we should click again on the word, go to the "Properties" tab, choose the Term identification key that we want to show (see step 6). B. Glossary tooltip. Select the text that will be linked, open the "links" drop-down menu, and select "Glossary tooltip". Then we should click again on the word, go to the "Properties" tab, choose the "Term" property and select the word that we would like to show.
-
Components | Connector glossary
"Connector to glossary" component allows you to link an external glossary, created with the "Tokyo Glossary" template. So, we could have a glossary common to several units and have it shared among all of them. It's recommended to add it in a pop-up. After adding the component, we access the "Properties" tab where we can: Create: allows you to create a glossary from the "Tokyo Glossary" template from scratch. Link: allows you to search an existing glossary and link it. Unlink: removes the existing link to a glossary. Edit: allows you enter in the edition mode of the linked glossary and modify it.
-
Activities
The TOKYO ACTIVITIES template allows you to add a questionnaire and add different types of questions to it. All we have to do is: Access the "Add" tab and include a questionnaire. See how to create and configure it here. Then you can add various types of activities inside. See the different types of activities available and how to set them up here. Questionnaires created with this template can: Be published and used in an LMS, as a separate unit of content. (See how unit publications are made here). Be linked to a unit created with the Tokyo template using the "Connector to Questionnaire" component (See how to use this component here).