Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Copy/Paste Unit How-To #456

Merged
merged 1 commit into from
Jan 18, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
14 changes: 9 additions & 5 deletions source/educators/how-tos/copy_paste_course_content.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,12 +3,13 @@ Copy and Paste Course Content

.. note::

The copy/paste function can currently be used at the component-level of the
course outline. In other words, it can be used with text blocks, video blocks,
and problem blocks. In future releases, the copy/paste function will be
available for other levels of the course outline, including units, subsections
and sections.
The copy/paste function can currently be used at the component-level or the
unit level of the course outline. In other words, it can be used with text
blocks, video blocks, and problem blocks, as well as course units.

This page describes how to use copy/paste for components.

For instructions on unit-level copy/paste, see :doc:`copy_paste_units`

#. Choose a component that you would like to copy. This may be a text block, a video block or a problem block.

Expand All @@ -34,3 +35,6 @@ Copy and Paste Course Content
components. Once a component is pasted, it functions as an independent
entity and any changes made to the new version will not be reflected
in the original.

.. seealso::
:doc:`copy_paste_units`
80 changes: 80 additions & 0 deletions source/educators/how-tos/copy_paste_units.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
Copy and Paste Course Units
###########################

There are two options for copying and pasting a unit:

#. From the Course Outline page
#. From the Unit Page

From the Course Outline page
****************************

#. Choose a unit that you would like to copy.
#. In the "actions" hamburger in the upper right corner of the unit, click "Copy
to Clipboard".

.. image:: /_images/educator_how_tos/copy_paste_outline_page_copy_button.png
:alt: The "Copy to Clipboard" button is shown from the hamburger menu on a Unit

#. A notification will appear in the bottom right-hand side of the screen
indicating the copy is complete. It should only take a few seconds, depending
on the size of the unit.

#. Navigate to the subsection (in the course outline) where you'd like to paste
the unit. This may be in the same course or a different course.

#. Click "Paste Unit". The copied unit will appear as the next unit within the
subsection. (Note: The "Paste Unit" button will not be visible unless you
have copied a unit per step 2.)

.. image:: /_images/educator_how_tos/copy_paste_outline_page_paste_button.png
:alt: The paste button appears in the outline page within a subsection, below the "New Unit" button


From the Unit Page
******************

#. Choose the unit that you would like to copy from the top horizontal
navigation bar.

.. image:: /_images/educator_how_tos/copy_paste_unit_page_nav.png
:alt: In Studio, the unit editing page is shown, which displays all the units in a subsection in a horizontal navigation bar.

#. Click the "Copy Unit" button from the right-hand sidebar widget.

.. image:: /_images/educator_how_tos/copy_paste_unit_page_copy_button.png
:alt: The "Copy Unit" button appears in the right sidebar, below the "Publish" button

#. A notification will appear in the bottom right-hand side of the screen
indicating the copy is complete. It should only take a few seconds, depending
on the size of the unit.

#. Navigate to the subsection where you'd like to paste the unit. This may be in
the same course or a different course.

#. In the horizontal navigation bar, click on the dropdown arrow next to the
"+New Unit" button.

#. Click "Paste as new unit".

.. image:: /_images/educator_how_tos/copy_paste_unit_page_paste_as_new_unit.png
:alt: The "Paste as new unit" button appears in the "+New Unit" dropdown menu

#. Click "Paste Unit". The copied unit will appear as the newest unit within the
subsection.

.. image:: /_images/educator_how_tos/copy_paste_unit_page_paste_unit.png
:alt: The "Paste Unit" button in the horizontal nav bar is shown

#. If you'd like to reorder the newly pasted unit in the subsection, navigate
back to the Course Outline page and move the unit.

.. image:: /_images/educator_how_tos/course_outline_drag_to_reorder_unit.png
:alt: Units can be reordered within a subsection by visiting the Course Outline page and dragging the unit to its desired location


.. note::
Authors can also paste Units copied from the Unit Page into the Course Outline, and vice versa.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good, it might be worth having a See-also section with links to copy-pasting content, which someone who is looking at this might also be interested in.

Example code for seealso: https://docs.openedx.org/en/latest/documentors/references/doc_templates.html#create-a-how-to


.. seealso::
:doc:`copy_paste_course_content`
3 changes: 2 additions & 1 deletion source/educators/how-tos/index.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
Educators: How-tos
##################################
##################

.. grid:: 1 2 2 2
:gutter: 3
Expand Down Expand Up @@ -50,6 +50,7 @@ Educators: How-tos
add_image
add_content_iframe
copy_paste_course_content
copy_paste_units
manage_files
add_course_updates
import_scorm_content
Expand Down