[LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Portfolio_ShareFile.tex Portfolio_ShareFile_Group.tex Portfolio_ShareFile_Off.tex /interface portfolio.pm doc/help course.manual.texxml doc/loncapafiles loncapafiles.lpml

raeburn raeburn at source.lon-capa.org
Fri Sep 6 21:07:21 EDT 2024 

raeburn		Sat Sep  7 01:07:21 2024 EDT

  Added files:                 
    /loncom/html/adm/help/tex	Portfolio_ShareFile_Group.tex 
                             	Portfolio_ShareFile_Off.tex 

  Modified files:              
    /loncom/html/adm/help/tex	Portfolio_ShareFile.tex 
    /doc/loncapafiles	loncapafiles.lpml 
    /doc/help	course.manual.texxml 
    /loncom/interface	portfolio.pm 
  Log:
  - Help file link to right of "Current Access Status" column header in listing
    of Portfolio directory points at different file depending on context, and
    user's privileges.
  - Add documentation about sharing files in Group portolio to Course 
    Coordination manual.  
  
  
Index: loncom/html/adm/help/tex/Portfolio_ShareFile.tex
diff -u loncom/html/adm/help/tex/Portfolio_ShareFile.tex:1.4 loncom/html/adm/help/tex/Portfolio_ShareFile.tex:1.5
--- loncom/html/adm/help/tex/Portfolio_ShareFile.tex:1.4	Thu Apr 11 14:59:44 2013
+++ loncom/html/adm/help/tex/Portfolio_ShareFile.tex	Sat Sep  7 01:07:20 2024
@@ -1,11 +1,18 @@
 \label{Portfolio_ShareFile}
 
-You can allow other people to see/download your file. This is done by setting the access status of the various file. The access status of the file can be changed for both locked and unlocked files. There are 3 different status
+You can allow other people to see/download your file(s). This is done by setting the access status of the various file(s). The access status of a file can be changed for both locked and unlocked files. There are 4 different status types:
    
 \begin{itemize}
-\item Public access: Anyone can see/download your file via lon-capa
+\item Public access: Anyone can see/download your file
 \item Private access: Only you can see/download your file 
 \item Password protected access: To see/download your file, a person must enter the password that you have set.
+\item Conditional access: To see/download your file, a person must meet a specified condition, one of:
+    \begin{itemize}
+    \item be from a particular institution
+    \item be a particular person
+    \item have a role in a particular course
+    \item be using a computer in a particular location 
+    \end{itemize}
 \end{itemize} 
 
-To change the status of a file, click on the \underline{view/change status} link after the filename.
+To change the status of a file, click on the \underline{View/Change Status} link at far right for that particular filename.
Index: doc/loncapafiles/loncapafiles.lpml
diff -u doc/loncapafiles/loncapafiles.lpml:1.1070 doc/loncapafiles/loncapafiles.lpml:1.1071
--- doc/loncapafiles/loncapafiles.lpml:1.1070	Tue Sep  3 09:12:02 2024
+++ doc/loncapafiles/loncapafiles.lpml	Sat Sep  7 01:07:20 2024
@@ -2,7 +2,7 @@
  "http://lpml.sourceforge.net/DTD/lpml.dtd">
 <!-- loncapafiles.lpml -->
 
-<!-- $Id: loncapafiles.lpml,v 1.1070 2024/09/03 09:12:02 raeburn Exp $ -->
+<!-- $Id: loncapafiles.lpml,v 1.1071 2024/09/07 01:07:20 raeburn Exp $ -->
 
 <!--
 
@@ -3996,6 +3996,8 @@
 Portfolio_RenameFile.tex;
 Portfolio_ShareFile_ChangeSetting.tex;
 Portfolio_ShareFile_Conditional.tex;
+Portfolio_ShareFile_Group.tex;
+Portfolio_ShareFile_Off.tex;
 Portfolio_ShareFile_SetAccess.tex;
 Portfolio_ShareFile_StopAccess.tex;
 Portfolio_ShareFile.tex;
Index: doc/help/course.manual.texxml
diff -u doc/help/course.manual.texxml:1.54 doc/help/course.manual.texxml:1.55
--- doc/help/course.manual.texxml:1.54	Thu Jan 25 19:19:52 2024
+++ doc/help/course.manual.texxml	Sat Sep  7 01:07:21 2024
@@ -539,6 +539,9 @@
       <subsubsection name="Conditional Access">
         <file name="Portfolio_ShareFile_Conditional.tex" />
       </subsubsection>
+      <subsubsection name="Group Portfolio File Sharing">
+        <file name="Portfolio_ShareFile_Group.tex" />
+      </subsubsection>
     </subsection>
   </section>
 
Index: loncom/interface/portfolio.pm
diff -u loncom/interface/portfolio.pm:1.268 loncom/interface/portfolio.pm:1.269
--- loncom/interface/portfolio.pm:1.268	Thu Dec 28 18:14:07 2023
+++ loncom/interface/portfolio.pm	Sat Sep  7 01:07:21 2024
@@ -1,7 +1,7 @@
 # The LearningOnline Network
 # portfolio browser
 #
-# $Id: portfolio.pm,v 1.268 2023/12/28 18:14:07 raeburn Exp $
+# $Id: portfolio.pm,v 1.269 2024/09/07 01:07:21 raeburn Exp $
 #
 # Copyright Michigan State University Board of Trustees
 #
@@ -314,6 +314,18 @@
                 &mt('Using the portfolio file list'))
            .'</p>'
         );
+        my ($acl_helpfile,$acl_helplink);
+        if ($can_setacl) {
+            $acl_helpfile = 'Portfolio ShareFile';
+        } elsif ($caller eq 'coursegrp_portfolio') {
+            $acl_helpfile = 'Portfolio ShareFile Group';
+        }
+        unless ($can_setacl || $can_viewacl) {
+            $acl_helpfile = 'Portfolio ShareFile Off';
+        }
+        if ($acl_helpfile) {
+            $acl_helplink = &Apache::loncommon::help_open_topic($acl_helpfile);
+        }
         $r->print(&Apache::loncommon::start_data_table()
                  .&Apache::loncommon::start_data_table_header_row()
                  .'<th colspan="2">'.&mt('Actions'). &Apache::loncommon::help_open_topic('Portfolio FileAction').'</th>'
@@ -323,7 +335,7 @@
                  .'<th>'.&mt('Size').'</th>'
                  .'<th>'.&mt('Last Modified').'</th>'
                  .'<th> </th>'
-                 .'<th>'.&mt('Current Access Status').&Apache::loncommon::help_open_topic('Portfolio ShareFile').'</th>'
+                 .'<th>'.&mt('Current Access Status').$acl_helplink.'</th>'
                  .&Apache::loncommon::end_data_table_header_row());
     }
 

Index: loncom/html/adm/help/tex/Portfolio_ShareFile_Group.tex
+++ loncom/html/adm/help/tex/Portfolio_ShareFile_Group.tex
\label{portfolio_ShareFile_Group}
Course/Community Group Members who have been assigned the right to retrieve files from the group's portfolio, may also, depending on group privileges, have permission to set who else may view individual files in the portfolio.

There are 4 different file access types:

\begin{itemize}
\item Public access: Anyone can see/download the file
\item Private access: Only group members with portfolio access can see/download the file
\item Password protected access: To see/download the file, a person must enter the password set for the file
\item Conditional access: To see/download the file, a person must meet a specified condition, one of:
    \begin{itemize}
    \item be from a particular institution
    \item be a particular person
    \item have a role in a particular course
    \item be using a computer in a particular location
    \end{itemize}
\end{itemize}

Types other than 'private' can allow access by people who do not receive access by virtue of group membership.

If a \underline{View/Change Status} link is shown at far right for a particular filename you can use that to change the access status of the file. If instead a \underline{View Status} link is shown, you can use that to display information about the current access status for the file.

Index: loncom/html/adm/help/tex/Portfolio_ShareFile_Off.tex
+++ loncom/html/adm/help/tex/Portfolio_ShareFile_Off.tex
\label{Portfolio_ShareFile_Off}
A LON-CAPA administrator for your institution can enable or disable the setting of access controls for files in a user's portfolio space.

In your case, this feature has been disabled, so all files in your portfolio are Private, and only you can see them. The exception to this is when you select a file from your portfolio for submission to an assignment.  In that case course personnel will be able to view a locked version of the file for grading purposes.

More information about the LON-CAPA-cvs mailing list