diff --git a/app/src/main/java/fr/free/nrw/commons/upload/FailedUploadsAdapter.kt b/app/src/main/java/fr/free/nrw/commons/upload/FailedUploadsAdapter.kt index 926c8bca9..aa0d6bd3d 100644 --- a/app/src/main/java/fr/free/nrw/commons/upload/FailedUploadsAdapter.kt +++ b/app/src/main/java/fr/free/nrw/commons/upload/FailedUploadsAdapter.kt @@ -17,7 +17,14 @@ import fr.free.nrw.commons.R import fr.free.nrw.commons.contributions.Contribution import java.io.File - +/** + * Adapter for displaying failed uploads in a paginated list in FailedUploadsFragment. This adapter + * binds the data from [Contribution] objects to the item views in the RecyclerView, allowing users to view + * details of failed uploads, retry them, or delete them. + * + * @param callback The callback to handle user actions such as Delete Uploads and Restart Uploads + * on failed uploads. + */ class FailedUploadsAdapter(callback: Callback) : PagedListAdapter(ContributionDiffCallback()) { private var callback: Callback = callback diff --git a/app/src/main/java/fr/free/nrw/commons/upload/PendingUploadsAdapter.kt b/app/src/main/java/fr/free/nrw/commons/upload/PendingUploadsAdapter.kt index da2cf8db5..49e6f592d 100644 --- a/app/src/main/java/fr/free/nrw/commons/upload/PendingUploadsAdapter.kt +++ b/app/src/main/java/fr/free/nrw/commons/upload/PendingUploadsAdapter.kt @@ -18,7 +18,13 @@ import fr.free.nrw.commons.contributions.Contribution import timber.log.Timber import java.io.File - +/** + * Adapter for displaying pending uploads in a paginated list in PendingUploadsFragment. This adapter + * binds data from [Contribution] objects to the item views in the RecyclerView, allowing users to + * view details of pending uploads and perform actions such as deleting them. + * + * @param callback The callback to handle user actions such as Delete Uploads on pending uploads. + */ class PendingUploadsAdapter(private val callback: Callback) : PagedListAdapter(ContributionDiffCallback()) { diff --git a/app/src/main/java/fr/free/nrw/commons/upload/UploadProgressActivity.kt b/app/src/main/java/fr/free/nrw/commons/upload/UploadProgressActivity.kt index 9b4c25c1a..82483fa3c 100644 --- a/app/src/main/java/fr/free/nrw/commons/upload/UploadProgressActivity.kt +++ b/app/src/main/java/fr/free/nrw/commons/upload/UploadProgressActivity.kt @@ -104,6 +104,14 @@ class UploadProgressActivity : BaseActivity() { return true } + /** + * Updates the menu items based on the current position in the view pager and the visibility + * of icons related to pending or failed uploads. This function dynamically modifies the menu + * to display pause, resume, retry, and cancel options depending on the state of the uploads. + * + * @param currentPosition The current position in the view pager. A value of `0` indicates + * pending uploads, while `1` indicates failed uploads. + */ fun updateMenuItems(currentPosition: Int) { if (menu != null) { menu!!.clear()